Server Wallets Quickstart ⚡

Create server wallets on Story in under 5 minutes

In this quickstart, you will create new user wallets on Story.

This quickstart is under development as new features are added to the Story Protocol daily.

Preparation Steps

1. Create a Developer Account and Project

   To get started, create a developer account in the Crossmint Staging Console. Open that link, sign in, and accept the dialog to continue.

   Crossmint offers two consoles: staging, for development and testing, and production.

2. Get an API Key

   Create a server-side API key with these scopes: wallets.create, wallets:transactions.create, wallets:transactions.sign.

   This allows your API key to create new server wallets.

Create Server Wallets

1. Choose a Wallet Type

   Below is a summary of available wallet types and their characteristics:

   Custodial	Type	Admin Signer
   True	evm-smart-wallet	evm-fireblocks-custodial
   False	evm-smart-wallet	evm-keypair

2. Create a Wallet

   createWallet.ts

   const response = await fetch("https://staging.crossmint.com/api/2022-06-09/wallets", {
       method: "POST",
       headers: {
           "X-API-KEY": "<YOUR_API_KEY>",
           "Content-Type": "application/json",
       },
       body: JSON.stringify({
           type: "<WALLET_TYPE>",
           // Here you can pass a user ID, email, phone number, twitter handle etc. depending on how the user is identified in your application
           linkedUser: "email:[e-mail]",
           config:{
               adminSigner: {type: "<ADMIN_SIGNER>"},
           }
       }),
   });
   
   const wallet = await response.json();
   console.log("Wallet created:", wallet);
   

   Now, run the script:

   TypeScript

   npx tsx createWallet.ts
   

Send Arbitrary Transaction

1. Prepare the transaction

   Set up a Story Protocol client using the wallet created in the previous step and prepare a transaction to create a new NFT collection

   prepareTransaction.ts

   const client = StoryClient.newClient({
       transport: http(RPC_PROVIDER_URL),
       account: wallet.address,
   });
   
   const creationTx = await client.nftClient.createNFTCollection({
       name: "A collection of IP fantasy assets",
       symbol: "XMT",
       contractURI: "ipfs://QmXYnQJjUxojhh6NKkxPkcXNKFo4pU2hxUyJjqzTcQL9rE",
       isPublicMinting: true,
       mintOpen: true,
       mintFeeRecipient: wallet.address,
       txOptions: {
           encodedTxDataOnly: true,
       },
   });
   
2. Send the transaction

   Send the prepared transaction to Crossmint’s API, which handles the blockchain interaction. The transaction creates the NFT collection on Story Protocol’s network without requiring user’s signature or handling of gas fees.

   createTransaction.ts

   const response = await fetch(`https://staging.crossmint.com/api/2022-06-09/wallets/${wallet.address}/transactions`, {
       method: "POST",
       headers: {
           "X-API-KEY": "<YOUR_API_KEY>",
           "Content-Type": "application/json",
       },
       body: JSON.stringify({
           params: {
               call: {
                   // Encoded transaction data
                   data: creationTx.encodedTxData.data,
                   // Transaction destination
                   to: creationTx.encodedTxData.to,
               },
               chain: "story-testnet",
           },
       }),
   });
   
   const transaction = await response.json();
   console.log("Transaction created:", transaction.id);
   

   Story Protocol transactions through Crossmint smart wallets are completely gas-free! You can focus on building your application without worrying about managing gas fees or token balances.

3. Monitor Transaction Status

   Check the transaction status using the transaction ID.

   checkStatus.js

   const response = await fetch(
       `https://staging.crossmint.com/api/2022-06-09/wallets/${wallet.address}/transactions/${transaction.id}`,
       {
           method: "GET",
           headers: {
               "X-API-KEY": "<YOUR_API_KEY>",
           },
       }
   );
   
   const status = await response.json();
   console.log("Status:", status.status);