Documentation Index
Fetch the complete documentation index at: https://docs.biconomy.io/llms.txt
Use this file to discover all available pages before exploring further.
Choose the execution mode that matches your wallet infrastructure.
- EOA
- EOA-7702
- Smart Account
Standard EOA Mode
Use this mode for standard Ethereum external wallet accounts from wallets like MetaMask, Rabby, or Trust Wallet or when using WalletConnect.Key requirements:- Requires
fundingTokensparameter - One signature per funding token (1 token = 1 signature, 2 tokens = 2 signatures)
const quoteRequest = {
mode: "eoa",
ownerAddress: "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
fundingTokens: [
{
tokenAddress: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
chainId: 1,
amount: "1000000000"
}
],
composeFlows: [...],
// other parameters
};
const response = await fetch('https://api.biconomy.io/v1/quote', {
method: 'POST',
headers: {
'X-API-Key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify(quoteRequest)
});
EIP-7702 Delegated Mode
Use this mode if you have access to EIP-7702 delegation, typically available through embedded wallet providers like Privy, Dynamic, or Trust, or if you have direct access to the private key (e.g. on the backend).When to use:- Your users have embedded wallets that support EIP-7702
- You want to leverage delegation features
const quoteRequest = {
mode: "eoa-7702",
ownerAddress: "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
authorizations: [
{
address: "0x00000069E0Fb590E092Dd0E36FF93ac28ff11a3a",
chainId: 8453,
nonce: 38,
r: "0x192a2503401595804c35cdc5b748fe35cceb77ef534bf5d670f7797376487ded",
s: "0x1fd3c8acd0b7c5f64a8d72c35c39988544fca961b838277ab11750041cccc3d1",
yParity: 1
}
],
composeFlows: [...],
// other parameters
};
const response = await fetch('https://api.biconomy.io/v1/quote', {
method: 'POST',
headers: {
'X-API-Key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify(quoteRequest)
});
Getting EIP-7702 Authorization
If you don’t have the authorization yet, use the 412 fallback pattern:// Step 1: Try quote without authorization
let quoteResponse = await fetch('https://api.biconomy.io/v1/quote', {
method: 'POST',
headers: {
'X-API-Key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
mode: "eoa-7702",
ownerAddress: "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
composeFlows: [...]
})
});
// Step 2: Handle 412 error (missing authorization)
if (quoteResponse.status === 412) {
const error = await quoteResponse.json();
const authItems = error.authorizations;
// Step 3: Sign authorizations
const signedAuths = await Promise.all(
authItems.map(async (authItem) => {
const authorization = await walletClient.signAuthorization({
...authItem,
account
});
return {
...authorization,
yParity: authorization.yParity,
v: authorization.v?.toString()
};
})
);
// Step 4: Retry quote with authorizations
quoteResponse = await fetch('https://api.biconomy.io/v1/quote', {
method: 'POST',
headers: {
'X-API-Key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
mode: "eoa-7702",
ownerAddress: "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
composeFlows: [...],
authorizations: signedAuths
})
});
}
const quote = await quoteResponse.json();
Smart Account Mode
Use this mode if your application is built on native ERC-7579 smart accounts, such as Biconomy Nexus accounts.When to use:- You’ve deployed Biconomy Nexus accounts for your users
- Your app uses ERC-7579 compatible smart accounts
const quoteRequest = {
mode: "smart-account",
ownerAddress: "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
composeFlows: [...],
// other parameters
};
const response = await fetch('https://api.biconomy.io/v1/quote', {
method: 'POST',
headers: {
'X-API-Key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify(quoteRequest)
});