Delegated Signers

Register a delegated signer

Give third parties the possibility to transact with your wallet. Always maintain control over what that key can do with tight permissions and being able to revoke them at any time.

Prerequisites

• Ensure you have a wallet created.
• API Key: Ensure you have an API key with the scopes: wallets:signatures.create and wallets:transactions.create.

Adding a delegated signer

React

import { useWallet } from '@crossmint/client-sdk-react-ui';

const { wallet } = useWallet();

await wallet.addDelegatedSigner({
    signer: externalSigner,
});

Parameters

signer · string | object · required

The locator of the signer to add.

Returns

wallet · Wallet

The wallet with the new delegated signer.

Node.js

const wallet = await crossmintWallets.getWallet(walletLocator);

await wallet.addDelegatedSigner({
    signer: externalSigner,
});

Parameters

signer · string | object · required

The locator of the signer to add.

Returns

wallet · Wallet

The wallet with the new delegated signer.

React Native

import { useWallet } from '@crossmint/client-sdk-react-native-ui';

const { wallet } = useWallet();

await wallet.addDelegatedSigner({
    signer: externalSigner,
});

Parameters

signer · string | object · required

The locator of the signer to add.

Returns

wallet · Wallet

The wallet with the new delegated signer.

Getting all delegated signers

React

import { useWallet } from '@crossmint/client-sdk-react-ui';

const { wallet } = useWallet();

const signers = await wallet.delegatedSigners();

Returns

signers · DelegatedSigner[]

The delegated signers.

Node.js

const wallet = await crossmintWallets.getWallet(walletLocator);

const signers = await wallet.delegatedSigners();

Returns

signers · DelegatedSigner[]

The delegated signers.

React Native

React Native

import { useWallet } from '@crossmint/client-sdk-react-native-ui';

const { wallet } = useWallet();

const signers = await wallet.delegatedSigners();

Returns

signers · DelegatedSigner[]

The delegated signers.

Adding delegated signers with expiration date

React

import { useWallet } from '@crossmint/client-sdk-react-ui';

const { wallet } = useWallet();

await wallet.addDelegatedSigner({
    signer: externalSigner,
    expiresAt: new Date(Date.now() + 1000 * 60 * 60 * 24 * 30).getTime(),
});

Parameters

signer · string | object · required

The locator of the signer to add.

expiresAt · number

The expiration date of the delegated signer.

Node.js

const wallet = await crossmintWallets.getWallet(walletLocator);

await wallet.addDelegatedSigner({
    signer: externalSigner,
    expiresAt: new Date(Date.now() + 1000 * 60 * 60 * 24 * 30).getTime(),
});

Parameters

signer · string | object · required

The locator of the signer to add.

expiresAt · number

The expiration date of the delegated signer.

React Native

React Native

import { useWallet } from '@crossmint/client-sdk-react-native-ui';

const { wallet } = useWallet();

await wallet.addDelegatedSigner({
    signer: externalSigner,
    expiresAt: new Date(Date.now() + 1000 * 60 * 60 * 24 * 30).getTime(),
});

Parameters

signer · string | object · required

The locator of the signer to add.

expiresAt · number

The expiration date of the delegated signer.

Permissions

Permissions are available under private access. Contact us if you need access

React

import { useWallet } from '@crossmint/client-sdk-react-ui';

const { wallet } = useWallet();

await wallet.addDelegatedSigner({
    signer: externalSigner,
    permissions: permissions,
});

Parameters

signer · string | object · required

The locator of the signer to add.

permissions · Permission[]

The permissions to add.

Node.js

const wallet = await crossmintWallets.getWallet(walletLocator);

await wallet.addDelegatedSigner({
    signer: externalSigner,
    permissions: permissions,
});

Parameters

signer · string | object · required

The locator of the signer to add.

permissions · Permission[]

The permissions to add.

React Native

React Native

import { useWallet } from '@crossmint/client-sdk-react-native-ui';

const { wallet } = useWallet();

await wallet.addDelegatedSigner({
    signer: externalSigner,
    permissions: permissions,
});

Parameters

signer · string | object · required

The locator of the signer to add.

permissions · Permission[]

The permissions to add.

Available Permissions

Token Transfers

const permissions = [
    {
        type: "token-transfer",
        data: {
            allowance: allowance,
            token: tokenLocator,
        },
    },
];

Gas Limit

const permissions = [
    {
        type: "gas-limit",
        data: {
            limit: limit, // Maximum gas in decimal string
        },
    },
];

Call Limit

const permissions = [
    {
        type: "call-limit",
        data: {
            count: count, // Maximum number of calls
        },
    },
];