Skip to main content

​
Usage

const bearerToken = await getBearerToken(); // Your auth implementation

const newWallet = await browserClient.createWallet({
  params: {
    encryptKey: "user-secure-pin",
    externalUserId: "your-user-id-123",
    chain: "STARKNET",
  },
  bearerToken: bearerToken,
});

​
Parameters

  • encryptKey (string): A user-defined code or password used to encrypt the wallet’s private key.
  • externalUserId (string): Your application’s unique identifier for the user
  • chain (string): The blockchain network for the wallet. Currently only "STARKNET" is supported.
  • bearerToken (string): Bearer token for authentication

​
Return Value

Returns a Promise that resolves to an object containing:
  • wallet: Object with publicKey and encryptedPrivateKey
  • txHash: Transaction hash of the wallet deployment

​
Example Implementation

import { ChipiBrowserSDK } from "@chipi-stack/backend";

const browserClient = new ChipiBrowserSDK({
  apiPublicKey: process.env.VITE_CHIPI_PUBLIC_KEY, // or your framework's env var
});

async function createUserWallet(userId: string, userPin: string) {
  try {
    const bearerToken = await getBearerToken(); // Your auth implementation
    
    const newWallet = await browserClient.createWallet({
      params: {
        encryptKey: userPin,
        externalUserId: userId,
        chain: "STARKNET",
      },
      bearerToken: bearerToken,
    });

    console.log('Wallet created successfully!');
    console.log('Address:', newWallet.wallet.publicKey);
    console.log('Deployment TX:', newWallet.txHash);

    // Store wallet data in your app state
    saveWalletToState({
      userId,
      publicKey: newWallet.wallet.publicKey,
      encryptedPrivateKey: newWallet.wallet.encryptedPrivateKey,
      deploymentTxHash: newWallet.txHash,
    });

    return newWallet;
  } catch (error) {
    console.error('Wallet creation failed:', error);
    throw error;
  }
}

// Usage example
async function onboardNewUser(userId: string, pin: string) {
  const wallet = await createUserWallet(userId, pin);
  
  // Verify deployment on StarkScan
  const contractUrl = `https://starkscan.co/contract/${wallet.wallet.publicKey}`;
  console.log('View contract:', contractUrl);
  
  return wallet;
}
  • getWallet - Retrieve existing wallet information
  • transfer - Send tokens from the created wallet