@biconomy/permission-context-builder is a TypeScript library designed to facilitate the creation and management of smart sessions for blockchain interactions. It provides utilities for generating permission contexts, encoding session data, and handling various types of signers including EOA (Externally Owned Accounts) and Passkeys.
- Generate permission contexts for smart contract interactions
- Support for multiple signer types (EOA and Passkeys)
- Encoding and decoding of DID (Decentralized Identifier) keys
- Integration with Viem for Ethereum interactions
- Utilities for handling smart account permissions and policies
npm install @biconomy/permission-context-builder
To generate a permission context for a smart contract interaction:
import { getContext } from '@biconomy/permission-context-builder';
import { createWalletClient, http } from 'viem';
import { baseSepolia } from 'viem/chains';
const walletClient = createWalletClient({
account,
transport: http(),
chain: baseSepolia,
});
const context = await getContext(walletClient, {
signer: {
type: 'keys',
data: {
ids: [
"did:key:zDnaerx...", // Your DID key here
"did:key:zDnaerDaTF5BXEavCrfRZEk316dpbLsfPDZ3WJ5hRTPFU2169"
],
}
},
smartAccountAddress: walletClient.account?.address,
permissions: [
{
type: {
custom: 'donut-purchase'
},
data: {
target: donutContractAddress,
abi: donutContractAbi,
valueLimit: parseEther('0.001'),
functionName: 'function purchase()'
},
policies: [],
required: true
}
],
expiry: Date.now() + 1000
});
To decode a DID key:
import { decodeDIDToPublicKey } from '@biconomy/permission-context-builder';
const result = decodeDIDToPublicKey("did:key:zDnaerDaTF5BXEavCrfRZEk316dpbLsfPDZ3WJ5hRTPFU2169");
console.log(result.key); // Public key
console.log(result.keyType); // Key type (e.g., "secp256r1")
Generates a permission context for smart contract interactions.
walletClient
: Viem WalletClient instanceoptions
: Object containing:signer
: Signer informationsmartAccountAddress
: Address of the smart accountpermissions
: Array of permission objectsexpiry
: Expiration timestamp
Returns: Promise<string>
- The generated context as a hexadecimal string
Decodes a DID key to its public key and key type.
didKey
: DID key string
Returns: { key: string, keyType: string }
To run the test suite:
npm test
Contributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the MIT License.