MPC Quickstart

This is the fastest path to a working self-custodial wallet. No seed phrase. You hold the wallet and the WalletSuite signing service holds a co-signing share, so both are needed to sign. A few steps and you have a signed transaction on chain.

Prerequisites

A WalletSuite API key with wallet signing access. See Credentials & Authentication.
The SDK runtime for your language. See the SDK reference for available runtimes.

export WALLETSUITE_API_KEY="your-api-key"

Steps

Install the SDK

Add the WalletSuite wallet SDK to your project.

npm install @walletsuite/wallet

pip install walletsuite-wallet

Create your wallet

Create an SDK client pointed at the WalletSuite signing service and pass your API key.Creating the wallet returns the wallet blob. Save it to your own storage before you continue, since you hold it and WalletSuite does not.

const { MpcClient } = require("@walletsuite/wallet");

const client = new MpcClient(
  "https://cosigner.walletsuite.io",
  process.env.WALLETSUITE_API_KEY
);

const wallet = await client.createWallet();
await saveWallet(wallet); // your storage

import os
import walletsuite_wallet as ws

client = ws.MpcClient(
    "https://cosigner.walletsuite.io",
    api_key=os.environ["WALLETSUITE_API_KEY"],
)

wallet = client.create_wallet()
save_wallet(wallet)  # your storage

Persist the wallet to durable storage you control, never a temp directory, and keep a secure backup. Your backup is your recovery. It is 2-of-2 by default. For storage patterns, see Shares & thresholds.

Derive an address

Turn the wallet into an on-chain address. This runs locally with no network call. One wallet works everywhere, so the same wallet derives addresses across 84 chains.

const address = client.deriveAddress(wallet, "base");

address = client.derive_address(wallet, "base")

One wallet covers every chain. Pass it to deriveAddress for any of them. See One wallet, every chain.

Sign the transaction

Sign with signEvm7702, which signs the EIP-7702 (type-4) smart-account transaction format and returns it ready to broadcast.Each signature is authorized automatically: the SDK mints a single-use, payload-bound signing intent for you, so you pass only the transfer. See Signing intents for how that works under the hood.

Argument group	Type
Amounts and per-gas fees (value, max priority fee, max fee)	wei. Decimal strings in Node, integers in Python.
chain id, nonce, gas limit	plain numbers

const signed = await client.signEvm7702(
  wallet,
  8453,                            // chain id (Base)
  0,                               // nonce
  "0xRecipientAddress",
  "1000000000000",                 // value, wei
  "1000000000",                    // max priority fee per gas, wei
  "2000000000",                    // max fee per gas, wei
  300000,                          // gas limit
  null,                            // token (null for native)
  null,                            // data
  null,                            // delegate
  null                             // path
);

signed.raw; // broadcast-ready transaction

signed = client.sign_evm_7702(
    wallet,
    8453,                              # chain id (Base)
    0,                                 # nonce
    "0xRecipientAddress",
    1_000_000_000_000,                 # value, wei
    1_000_000_000,                     # max priority fee per gas, wei
    2_000_000_000,                     # max fee per gas, wei
    300_000,                           # gas limit
)

signed.raw  # broadcast-ready transaction

The SDK signs but does not broadcast, so send the result in the next step. For more signing paths, see Signing.

Broadcast the transaction

Submit the signed transaction. Use your own RPC, or POST the raw transaction to WalletSuite and check status by hash. See the send endpoint reference at https://api.walletsuite.io/docs#tag/transactions/POST/api/txs/send.

curl -X POST "https://api.walletsuite.io/api/txs/send" \
  -H "x-api-key: $WALLETSUITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "chain": "base", "signedTx": "0x..." }'

curl "https://api.walletsuite.io/api/txs/status/0xTransactionHash?chain=base" \
  -H "x-api-key: $WALLETSUITE_API_KEY"

For confirmation handling and event-driven delivery, see Broadcasting. To react to confirmed transfers without polling, see Webhooks.

Next steps

End-to-end walkthrough

The complete journey from wallet creation to a confirmed transaction.

Signing intents

How every signature is pre-authorized under the hood, with nothing to implement.

Signing

Every signing path across 84 chains.

Broadcasting

Submit signed transactions through WalletSuite or your own RPC, and track confirmation.

Get Started

Concepts

Building

Reference

Prerequisites

Steps

Next steps

End-to-end walkthrough

Signing intents

Signing

Broadcasting

​Prerequisites

​Steps

​Next steps

End-to-end walkthrough

Signing intents

Signing

Broadcasting

Prerequisites

Steps

Next steps