Skip to main content

Keyban JavaScript SDK

Overview​

The Keyban JavaScript SDK provides the core functionality for Keyban's MPC wallet solution, simplifying the development of web and Node.js applications. It offers essential configurations, utilities, and functions that serve as the foundation for creating decentralized wallet experiences.

Key Features​

  • TypeScript Support: Fully typed to enhance code quality and development experience.
  • Flexible Storage: Support for custom storage solutions, with built-in options coming soon.
  • Blockchain Support: Supports Ethereum testnets and the Polygon Amoy testnet.
  • ERC-20, ERC-721, and ERC-1155 Support: Transfer and interact with ERC-20 tokens and NFTs (ERC-721 and ERC-1155).
  • Bundling: Efficiently bundled using tsup for optimized builds in development and production.

Installation​

npm install @keyban/sdk-base

Basic Example​

Initialize the SDK​

import { KeybanClient, KeybanChain, KeybanAccount } from '@keyban/sdk-base';

const client = new KeybanClient({
  appId: "your-keyban-app-id",                 // Your Keyban application ID
  accessTokenProvider: async () => "access-token", // Function to provide the access token
  chain: KeybanChain.KeybanTestnet,            // Select the desired blockchain network
});

Retrieve Account Information​

const account: KeybanAccount = await client.initialize();

Estimate Transaction Fees​

const transferEstimate = await account.estimateTransfer("0xRecipientAddress", BigInt('1000000000000000000')); // 1 ETH in wei

Perform Token Transfer​

await account.transfer("0xRecipientAddress", BigInt('1000000000000000000'));
console.log(`Transferred 1 ETH to 0xRecipientAddress`);

Retrieve ERC-20 Token Balances​

const tokenBalances = await client.getTokenBalances(account.address);
console.log('ERC-20 Token Balances:', tokenBalances);

Perform ERC-20 Token Transfer​

const erc20Estimate = await account.estimateERC20Transfer({
  contractAddress: "0xTokenContractAddress",   // ERC-20 contract address
  to: "0xRecipientAddress",                    // Recipient address
  value: BigInt('500000000000000000'),         // Amount to transfer (0.5 tokens in wei)
});
await account.transferERC20({
  contractAddress: "0xTokenContractAddress",
  to: "0xRecipientAddress",
  value: BigInt('500000000000000000'),
});
console.log(`Transferred 0.5 tokens to 0xRecipientAddress`);

Retrieve NFTs Owned by the Account​

const nfts = await client.getNfts(account.address);
console.log('Owned NFTs:', nfts);

Perform NFT Transfer​

const nftEstimate = await account.estimateNftTransfer({
  contractAddress: "0xNftContractAddress",
  to: "0xRecipientAddress",
  tokenId: BigInt(1),                          // Token ID
  standard: 'ERC721',                          // 'ERC721' or 'ERC1155'
});
await account.transferNft({
  contractAddress: "0xNftContractAddress",
  to: "0xRecipientAddress",
  tokenId: BigInt(1),
  standard: 'ERC721',
});
console.log(`Transferred NFT with Token ID 1 to 0xRecipientAddress`);

Supported Blockchains​

The Keyban SDK supports the following blockchains:

  • Keyban Testnet: KeybanChain.KeybanTestnet
  • Polygon Amoy Testnet: KeybanChain.PolygonAmoy

Support for additional blockchains and mainnets will be introduced in future releases.

Custom Storage and Signing​

Developers can define their own storage and signing strategies. The SDK offers flexibility with custom storage mechanisms, and future releases will bring more built-in storage options.

Documentation​

For more detailed API references and advanced features, visit the official Keyban API Reference Portal.