@veil-cash/sdk 0.2.0 → 0.3.0

package/dist/index.d.cts

@@ -79,7 +79,7 @@ declare class Utxo {
 /**
  * Supported tokens
  */
-type Token = 'ETH' | 'USDC';
+type Token = 'ETH' | 'USDC' | 'CBBTC';
 /**
  * Encrypted message format (x25519-xsalsa20-poly1305)
  */
@@ -99,6 +99,9 @@ interface NetworkAddresses {
     usdcPool: `0x${string}`;
     usdcQueue: `0x${string}`;
     usdcToken: `0x${string}`;
+    cbbtcPool: `0x${string}`;
+    cbbtcQueue: `0x${string}`;
+    cbbtcToken: `0x${string}`;
     chainId: number;
     relayUrl: string;
 }
@@ -177,7 +180,7 @@ interface PrivateBalanceResult {
 /**
  * Pool type for relay operations
  */
-type RelayPool = 'eth' | 'usdc';
+type RelayPool = 'eth' | 'usdc' | 'cbbtc';
 /**
  * Type of relay transaction
  */
@@ -269,6 +272,8 @@ interface BuildWithdrawProofOptions {
     recipient: `0x${string}`;
     /** User's keypair for signing */
     keypair: Keypair;
+    /** Pool to withdraw from (default: 'eth') */
+    pool?: RelayPool;
     /** Optional RPC URL */
     rpcUrl?: string;
     /** Progress callback */
@@ -284,6 +289,8 @@ interface BuildTransferProofOptions {
     recipientAddress: `0x${string}`;
     /** Sender's keypair */
     senderKeypair: Keypair;
+    /** Pool to transfer in (default: 'eth') */
+    pool?: RelayPool;
     /** Optional RPC URL */
     rpcUrl?: string;
     /** Progress callback */
@@ -351,6 +358,16 @@ interface UtxoSelectionResult {
  * Generates and manages keypairs for Veil deposits
  */
 
+/**
+ * Canonical message signed by a wallet to derive a Veil keypair.
+ * Must match the frontend's SIGNED_MESSAGE in data/wallet/config.ts.
+ */
+declare const VEIL_SIGNED_MESSAGE = "Sign this message to create your Veil Wallet private key. This will be used to decrypt your balances. Ensure you are signing this message on the Veil Cash website.";
+/**
+ * Any async function that performs EIP-191 personal_sign and returns a 0x-prefixed signature.
+ * Used with Keypair.fromSigner() to support external signing services.
+ */
+type MessageSigner = (message: string) => Promise<string>;
 /**
  * Pack encrypted message into hex string
  */
@@ -410,6 +427,59 @@ declare class Keypair {
      * @returns Keypair instance (privkey will be null)
      */
     static fromString(str: string): Keypair;
+    /**
+     * Derive a Keypair from an EIP-191 personal_sign signature.
+     * The private key is keccak256(signature) -- matching the frontend derivation.
+     *
+     * @param signature - Raw ECDSA signature (0x-prefixed, 132 hex chars)
+     * @returns Keypair derived from the signature
+     *
+     * @example
+     * ```typescript
+     * const keypair = Keypair.fromSignature(signature);
+     * ```
+     */
+    static fromSignature(signature: string): Keypair;
+    /**
+     * Derive a Keypair from an Ethereum wallet private key.
+     * Signs VEIL_SIGNED_MESSAGE with the wallet, then derives via keccak256(signature).
+     * Produces the same keypair as the frontend for the same wallet.
+     *
+     * @param walletPrivateKey - Ethereum EOA private key (0x-prefixed)
+     * @returns Promise resolving to the derived Keypair
+     *
+     * @example
+     * ```typescript
+     * const keypair = await Keypair.fromWalletKey('0xYOUR_WALLET_PRIVATE_KEY');
+     * console.log(keypair.depositKey()); // Same as frontend login with this wallet
+     * ```
+     */
+    static fromWalletKey(walletPrivateKey: `0x${string}`): Promise<Keypair>;
+    /**
+     * Derive a Keypair using any external signer that supports personal_sign (EIP-191).
+     * The signer function receives VEIL_SIGNED_MESSAGE and must return a 0x-prefixed signature.
+     * Works with any signing backend: Bankr, MPC wallets, custodial services, hardware wallets, etc.
+     *
+     * @param signer - Async function that signs a message and returns a 0x-prefixed signature
+     * @returns Promise resolving to the derived Keypair
+     *
+     * @example
+     * ```typescript
+     * // With Bankr
+     * const keypair = await Keypair.fromSigner(async (message) => {
+     *   const res = await fetch('https://api.bankr.bot/agent/sign', {
+     *     method: 'POST',
+     *     headers: { 'X-API-Key': apiKey, 'Content-Type': 'application/json' },
+     *     body: JSON.stringify({ signatureType: 'personal_sign', message }),
+     *   });
+     *   return (await res.json()).signature;
+     * });
+     *
+     * // With any custom signer
+     * const keypair = await Keypair.fromSigner(async (msg) => myService.personalSign(msg));
+     * ```
+     */
+    static fromSigner(signer: MessageSigner): Promise<Keypair>;
     /**
      * Sign a message using the private key
      * @param commitment - Commitment hash
@@ -452,6 +522,22 @@ declare class Keypair {
  * ```
  */
 declare function buildRegisterTx(depositKey: string, ownerAddress: `0x${string}`): TransactionData;
+/**
+ * Build a transaction to change an existing deposit key
+ * The caller must already be registered on-chain
+ *
+ * @param depositKey - New deposit key from Keypair.depositKey()
+ * @param ownerAddress - Address that owns the current deposit key (must be msg.sender)
+ * @returns Transaction data to send
+ *
+ * @example
+ * ```typescript
+ * const newKeypair = await Keypair.fromWalletKey('0x...');
+ * const tx = buildChangeDepositKeyTx(newKeypair.depositKey(), '0x...');
+ * // Send tx using your wallet
+ * ```
+ */
+declare function buildChangeDepositKeyTx(depositKey: string, ownerAddress: `0x${string}`): TransactionData;
 /**
  * Build a transaction to deposit ETH
  *
@@ -498,7 +584,31 @@ declare function buildDepositUSDCTx(options: {
     amount: string;
 }): TransactionData;
 /**
- * Build a deposit transaction (ETH or USDC)
+ * Build a transaction to approve cbBTC for deposit
+ * Must be called before depositCBBTC if allowance is insufficient
+ *
+ * @param options - Approval options
+ * @param options.amount - Amount to approve (human readable, e.g., '0.5')
+ * @returns Transaction data
+ */
+declare function buildApproveCBBTCTx(options: {
+    amount: string;
+}): TransactionData;
+/**
+ * Build a transaction to deposit cbBTC
+ * Note: You must approve cbBTC first using buildApproveCBBTCTx
+ *
+ * @param options - Deposit options
+ * @param options.depositKey - Deposit key from Keypair.depositKey()
+ * @param options.amount - Amount to deposit (human readable, e.g., '0.5')
+ * @returns Transaction data
+ */
+declare function buildDepositCBBTCTx(options: {
+    depositKey: string;
+    amount: string;
+}): TransactionData;
+/**
+ * Build a deposit transaction (ETH, USDC, or cbBTC)
  * Convenience function that routes to the correct builder
  *
  * @param options - Deposit options
@@ -519,6 +629,13 @@ declare function buildDepositUSDCTx(options: {
  *   amount: '100',
  *   token: 'USDC',
  * });
+ *
+ * // cbBTC deposit (remember to approve first!)
+ * const cbbtcTx = buildDepositTx({
+ *   depositKey: keypair.depositKey(),
+ *   amount: '0.5',
+ *   token: 'CBBTC',
+ * });
  * ```
  */
 declare function buildDepositTx(options: {
@@ -550,6 +667,7 @@ type ProgressCallback = (stage: string, detail?: string) => void;
  * ```typescript
  * const result = await getQueueBalance({
  *   address: '0x...',
+ *   pool: 'eth',
  *   onProgress: (stage, detail) => console.log(stage, detail),
  * });
  *
@@ -559,6 +677,7 @@ type ProgressCallback = (stage: string, detail?: string) => void;
  */
 declare function getQueueBalance(options: {
     address: `0x${string}`;
+    pool?: RelayPool;
     rpcUrl?: string;
     onProgress?: ProgressCallback;
 }): Promise<QueueBalanceResult>;
@@ -577,6 +696,7 @@ declare function getQueueBalance(options: {
  * const keypair = new Keypair(process.env.VEIL_KEY);
  * const result = await getPrivateBalance({
  *   keypair,
+ *   pool: 'eth',
  *   onProgress: (stage, detail) => console.log(stage, detail),
  * });
  *
@@ -586,6 +706,7 @@ declare function getQueueBalance(options: {
  */
 declare function getPrivateBalance(options: {
     keypair: Keypair;
+    pool?: RelayPool;
     rpcUrl?: string;
     onProgress?: ProgressCallback;
 }): Promise<PrivateBalanceResult>;
@@ -737,6 +858,7 @@ declare function transfer(options: BuildTransferProofOptions): Promise<TransferR
 declare function mergeUtxos(options: {
     amount: string;
     keypair: Keypair;
+    pool?: RelayPool;
     rpcUrl?: string;
     onProgress?: (stage: string, detail?: string) => void;
 }): Promise<TransferResult>;
@@ -943,12 +1065,30 @@ declare const POOL_CONFIG: {
         readonly symbol: "USDC";
         readonly name: "USD Coin";
     };
+    readonly cbbtc: {
+        readonly decimals: 8;
+        readonly displayDecimals: 6;
+        readonly symbol: "cbBTC";
+        readonly name: "Coinbase Bitcoin";
+    };
 };
 /**
  * Get contract addresses
  * @returns Contract addresses for Base mainnet
  */
 declare function getAddresses(): NetworkAddresses;
+/**
+ * Get the pool contract address for a given pool
+ * @param pool - Pool identifier ('eth', 'usdc', or 'cbbtc')
+ * @returns Pool contract address
+ */
+declare function getPoolAddress(pool: RelayPool): `0x${string}`;
+/**
+ * Get the queue contract address for a given pool
+ * @param pool - Pool identifier ('eth', 'usdc', or 'cbbtc')
+ * @returns Queue contract address
+ */
+declare function getQueueAddress(pool: RelayPool): `0x${string}`;
 /**
  * Get Relay URL
  * @returns Relay URL for Base mainnet
@@ -1188,6 +1328,22 @@ declare const ENTRY_ABI: readonly [{
     readonly outputs: readonly [];
     readonly stateMutability: "nonpayable";
     readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly components: readonly [{
+            readonly name: "owner";
+            readonly type: "address";
+        }, {
+            readonly name: "depositKey";
+            readonly type: "bytes";
+        }];
+        readonly name: "_account";
+        readonly type: "tuple";
+    }];
+    readonly name: "changeDepositKey";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
 }, {
     readonly inputs: readonly [{
         readonly name: "_depositKey";
@@ -1209,6 +1365,18 @@ declare const ENTRY_ABI: readonly [{
     readonly outputs: readonly [];
     readonly stateMutability: "nonpayable";
     readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly name: "_amount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "_depositKey";
+        readonly type: "bytes";
+    }];
+    readonly name: "queueBTC";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
 }, {
     readonly inputs: readonly [{
         readonly name: "";
@@ -2096,4 +2264,4 @@ declare function getExtDataHash(extData: ExtDataInput): bigint;
  */
 declare function shuffle<T>(array: T[]): T[];
 
-export { ADDRESSES, type BuildTransferProofOptions, type BuildWithdrawProofOptions, CIRCUIT_CONFIG, type DepositTxOptions, ENTRY_ABI, ERC20_ABI, type EncryptedMessage, type ExtData, type ExtDataInput, FIELD_SIZE, Keypair, MERKLE_TREE_HEIGHT, type NetworkAddresses, POOL_ABI, POOL_CONFIG, type PendingDeposit, type PoolConfig, type PrepareTransactionParams, type PrivateBalanceResult, type ProgressCallback, type ProofArgs, type ProofBuildResult, type ProofInput, QUEUE_ABI, type QueueBalanceResult, type RegisterTxOptions, RelayError, type RelayErrorResponse, type RelayExtData, type RelayMetadata, type RelayPool, type RelayProofArgs, type RelayRequest, type RelayResponse, type RelayType, type SubmitRelayOptions, type Token, type TransactionData, type TransactionResult, type TransferResult, Utxo, type UtxoInfo, type UtxoParams, type UtxoSelectionResult, type WithdrawResult, buildApproveUSDCTx, buildDepositETHTx, buildDepositTx, buildDepositUSDCTx, buildMerkleTree, buildRegisterTx, buildTransferProof, buildWithdrawProof, checkRecipientRegistration, checkRelayHealth, getAddresses, getExtDataHash, getMerklePath, getPrivateBalance, getQueueBalance, getRelayInfo, getRelayUrl, mergeUtxos, packEncryptedMessage, poseidonHash, poseidonHash2, prepareTransaction, prove, randomBN, selectCircuit, selectUtxosForWithdraw, shuffle, submitRelay, toBuffer, toFixedHex, transfer, unpackEncryptedMessage, withdraw };
+export { ADDRESSES, type BuildTransferProofOptions, type BuildWithdrawProofOptions, CIRCUIT_CONFIG, type DepositTxOptions, ENTRY_ABI, ERC20_ABI, type EncryptedMessage, type ExtData, type ExtDataInput, FIELD_SIZE, Keypair, MERKLE_TREE_HEIGHT, type MessageSigner, type NetworkAddresses, POOL_ABI, POOL_CONFIG, type PendingDeposit, type PoolConfig, type PrepareTransactionParams, type PrivateBalanceResult, type ProgressCallback, type ProofArgs, type ProofBuildResult, type ProofInput, QUEUE_ABI, type QueueBalanceResult, type RegisterTxOptions, RelayError, type RelayErrorResponse, type RelayExtData, type RelayMetadata, type RelayPool, type RelayProofArgs, type RelayRequest, type RelayResponse, type RelayType, type SubmitRelayOptions, type Token, type TransactionData, type TransactionResult, type TransferResult, Utxo, type UtxoInfo, type UtxoParams, type UtxoSelectionResult, VEIL_SIGNED_MESSAGE, type WithdrawResult, buildApproveCBBTCTx, buildApproveUSDCTx, buildChangeDepositKeyTx, buildDepositCBBTCTx, buildDepositETHTx, buildDepositTx, buildDepositUSDCTx, buildMerkleTree, buildRegisterTx, buildTransferProof, buildWithdrawProof, checkRecipientRegistration, checkRelayHealth, getAddresses, getExtDataHash, getMerklePath, getPoolAddress, getPrivateBalance, getQueueAddress, getQueueBalance, getRelayInfo, getRelayUrl, mergeUtxos, packEncryptedMessage, poseidonHash, poseidonHash2, prepareTransaction, prove, randomBN, selectCircuit, selectUtxosForWithdraw, shuffle, submitRelay, toBuffer, toFixedHex, transfer, unpackEncryptedMessage, withdraw };

package/dist/index.d.ts

@@ -79,7 +79,7 @@ declare class Utxo {
 /**
  * Supported tokens
  */
-type Token = 'ETH' | 'USDC';
+type Token = 'ETH' | 'USDC' | 'CBBTC';
 /**
  * Encrypted message format (x25519-xsalsa20-poly1305)
  */
@@ -99,6 +99,9 @@ interface NetworkAddresses {
     usdcPool: `0x${string}`;
     usdcQueue: `0x${string}`;
     usdcToken: `0x${string}`;
+    cbbtcPool: `0x${string}`;
+    cbbtcQueue: `0x${string}`;
+    cbbtcToken: `0x${string}`;
     chainId: number;
     relayUrl: string;
 }
@@ -177,7 +180,7 @@ interface PrivateBalanceResult {
 /**
  * Pool type for relay operations
  */
-type RelayPool = 'eth' | 'usdc';
+type RelayPool = 'eth' | 'usdc' | 'cbbtc';
 /**
  * Type of relay transaction
  */
@@ -269,6 +272,8 @@ interface BuildWithdrawProofOptions {
     recipient: `0x${string}`;
     /** User's keypair for signing */
     keypair: Keypair;
+    /** Pool to withdraw from (default: 'eth') */
+    pool?: RelayPool;
     /** Optional RPC URL */
     rpcUrl?: string;
     /** Progress callback */
@@ -284,6 +289,8 @@ interface BuildTransferProofOptions {
     recipientAddress: `0x${string}`;
     /** Sender's keypair */
     senderKeypair: Keypair;
+    /** Pool to transfer in (default: 'eth') */
+    pool?: RelayPool;
     /** Optional RPC URL */
     rpcUrl?: string;
     /** Progress callback */
@@ -351,6 +358,16 @@ interface UtxoSelectionResult {
  * Generates and manages keypairs for Veil deposits
  */
 
+/**
+ * Canonical message signed by a wallet to derive a Veil keypair.
+ * Must match the frontend's SIGNED_MESSAGE in data/wallet/config.ts.
+ */
+declare const VEIL_SIGNED_MESSAGE = "Sign this message to create your Veil Wallet private key. This will be used to decrypt your balances. Ensure you are signing this message on the Veil Cash website.";
+/**
+ * Any async function that performs EIP-191 personal_sign and returns a 0x-prefixed signature.
+ * Used with Keypair.fromSigner() to support external signing services.
+ */
+type MessageSigner = (message: string) => Promise<string>;
 /**
  * Pack encrypted message into hex string
  */
@@ -410,6 +427,59 @@ declare class Keypair {
      * @returns Keypair instance (privkey will be null)
      */
     static fromString(str: string): Keypair;
+    /**
+     * Derive a Keypair from an EIP-191 personal_sign signature.
+     * The private key is keccak256(signature) -- matching the frontend derivation.
+     *
+     * @param signature - Raw ECDSA signature (0x-prefixed, 132 hex chars)
+     * @returns Keypair derived from the signature
+     *
+     * @example
+     * ```typescript
+     * const keypair = Keypair.fromSignature(signature);
+     * ```
+     */
+    static fromSignature(signature: string): Keypair;
+    /**
+     * Derive a Keypair from an Ethereum wallet private key.
+     * Signs VEIL_SIGNED_MESSAGE with the wallet, then derives via keccak256(signature).
+     * Produces the same keypair as the frontend for the same wallet.
+     *
+     * @param walletPrivateKey - Ethereum EOA private key (0x-prefixed)
+     * @returns Promise resolving to the derived Keypair
+     *
+     * @example
+     * ```typescript
+     * const keypair = await Keypair.fromWalletKey('0xYOUR_WALLET_PRIVATE_KEY');
+     * console.log(keypair.depositKey()); // Same as frontend login with this wallet
+     * ```
+     */
+    static fromWalletKey(walletPrivateKey: `0x${string}`): Promise<Keypair>;
+    /**
+     * Derive a Keypair using any external signer that supports personal_sign (EIP-191).
+     * The signer function receives VEIL_SIGNED_MESSAGE and must return a 0x-prefixed signature.
+     * Works with any signing backend: Bankr, MPC wallets, custodial services, hardware wallets, etc.
+     *
+     * @param signer - Async function that signs a message and returns a 0x-prefixed signature
+     * @returns Promise resolving to the derived Keypair
+     *
+     * @example
+     * ```typescript
+     * // With Bankr
+     * const keypair = await Keypair.fromSigner(async (message) => {
+     *   const res = await fetch('https://api.bankr.bot/agent/sign', {
+     *     method: 'POST',
+     *     headers: { 'X-API-Key': apiKey, 'Content-Type': 'application/json' },
+     *     body: JSON.stringify({ signatureType: 'personal_sign', message }),
+     *   });
+     *   return (await res.json()).signature;
+     * });
+     *
+     * // With any custom signer
+     * const keypair = await Keypair.fromSigner(async (msg) => myService.personalSign(msg));
+     * ```
+     */
+    static fromSigner(signer: MessageSigner): Promise<Keypair>;
     /**
      * Sign a message using the private key
      * @param commitment - Commitment hash
@@ -452,6 +522,22 @@ declare class Keypair {
  * ```
  */
 declare function buildRegisterTx(depositKey: string, ownerAddress: `0x${string}`): TransactionData;
+/**
+ * Build a transaction to change an existing deposit key
+ * The caller must already be registered on-chain
+ *
+ * @param depositKey - New deposit key from Keypair.depositKey()
+ * @param ownerAddress - Address that owns the current deposit key (must be msg.sender)
+ * @returns Transaction data to send
+ *
+ * @example
+ * ```typescript
+ * const newKeypair = await Keypair.fromWalletKey('0x...');
+ * const tx = buildChangeDepositKeyTx(newKeypair.depositKey(), '0x...');
+ * // Send tx using your wallet
+ * ```
+ */
+declare function buildChangeDepositKeyTx(depositKey: string, ownerAddress: `0x${string}`): TransactionData;
 /**
  * Build a transaction to deposit ETH
  *
@@ -498,7 +584,31 @@ declare function buildDepositUSDCTx(options: {
     amount: string;
 }): TransactionData;
 /**
- * Build a deposit transaction (ETH or USDC)
+ * Build a transaction to approve cbBTC for deposit
+ * Must be called before depositCBBTC if allowance is insufficient
+ *
+ * @param options - Approval options
+ * @param options.amount - Amount to approve (human readable, e.g., '0.5')
+ * @returns Transaction data
+ */
+declare function buildApproveCBBTCTx(options: {
+    amount: string;
+}): TransactionData;
+/**
+ * Build a transaction to deposit cbBTC
+ * Note: You must approve cbBTC first using buildApproveCBBTCTx
+ *
+ * @param options - Deposit options
+ * @param options.depositKey - Deposit key from Keypair.depositKey()
+ * @param options.amount - Amount to deposit (human readable, e.g., '0.5')
+ * @returns Transaction data
+ */
+declare function buildDepositCBBTCTx(options: {
+    depositKey: string;
+    amount: string;
+}): TransactionData;
+/**
+ * Build a deposit transaction (ETH, USDC, or cbBTC)
  * Convenience function that routes to the correct builder
  *
  * @param options - Deposit options
@@ -519,6 +629,13 @@ declare function buildDepositUSDCTx(options: {
  *   amount: '100',
  *   token: 'USDC',
  * });
+ *
+ * // cbBTC deposit (remember to approve first!)
+ * const cbbtcTx = buildDepositTx({
+ *   depositKey: keypair.depositKey(),
+ *   amount: '0.5',
+ *   token: 'CBBTC',
+ * });
  * ```
  */
 declare function buildDepositTx(options: {
@@ -550,6 +667,7 @@ type ProgressCallback = (stage: string, detail?: string) => void;
  * ```typescript
  * const result = await getQueueBalance({
  *   address: '0x...',
+ *   pool: 'eth',
  *   onProgress: (stage, detail) => console.log(stage, detail),
  * });
  *
@@ -559,6 +677,7 @@ type ProgressCallback = (stage: string, detail?: string) => void;
  */
 declare function getQueueBalance(options: {
     address: `0x${string}`;
+    pool?: RelayPool;
     rpcUrl?: string;
     onProgress?: ProgressCallback;
 }): Promise<QueueBalanceResult>;
@@ -577,6 +696,7 @@ declare function getQueueBalance(options: {
  * const keypair = new Keypair(process.env.VEIL_KEY);
  * const result = await getPrivateBalance({
  *   keypair,
+ *   pool: 'eth',
  *   onProgress: (stage, detail) => console.log(stage, detail),
  * });
  *
@@ -586,6 +706,7 @@ declare function getQueueBalance(options: {
  */
 declare function getPrivateBalance(options: {
     keypair: Keypair;
+    pool?: RelayPool;
     rpcUrl?: string;
     onProgress?: ProgressCallback;
 }): Promise<PrivateBalanceResult>;
@@ -737,6 +858,7 @@ declare function transfer(options: BuildTransferProofOptions): Promise<TransferR
 declare function mergeUtxos(options: {
     amount: string;
     keypair: Keypair;
+    pool?: RelayPool;
     rpcUrl?: string;
     onProgress?: (stage: string, detail?: string) => void;
 }): Promise<TransferResult>;
@@ -943,12 +1065,30 @@ declare const POOL_CONFIG: {
         readonly symbol: "USDC";
         readonly name: "USD Coin";
     };
+    readonly cbbtc: {
+        readonly decimals: 8;
+        readonly displayDecimals: 6;
+        readonly symbol: "cbBTC";
+        readonly name: "Coinbase Bitcoin";
+    };
 };
 /**
  * Get contract addresses
  * @returns Contract addresses for Base mainnet
  */
 declare function getAddresses(): NetworkAddresses;
+/**
+ * Get the pool contract address for a given pool
+ * @param pool - Pool identifier ('eth', 'usdc', or 'cbbtc')
+ * @returns Pool contract address
+ */
+declare function getPoolAddress(pool: RelayPool): `0x${string}`;
+/**
+ * Get the queue contract address for a given pool
+ * @param pool - Pool identifier ('eth', 'usdc', or 'cbbtc')
+ * @returns Queue contract address
+ */
+declare function getQueueAddress(pool: RelayPool): `0x${string}`;
 /**
  * Get Relay URL
  * @returns Relay URL for Base mainnet
@@ -1188,6 +1328,22 @@ declare const ENTRY_ABI: readonly [{
     readonly outputs: readonly [];
     readonly stateMutability: "nonpayable";
     readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly components: readonly [{
+            readonly name: "owner";
+            readonly type: "address";
+        }, {
+            readonly name: "depositKey";
+            readonly type: "bytes";
+        }];
+        readonly name: "_account";
+        readonly type: "tuple";
+    }];
+    readonly name: "changeDepositKey";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
 }, {
     readonly inputs: readonly [{
         readonly name: "_depositKey";
@@ -1209,6 +1365,18 @@ declare const ENTRY_ABI: readonly [{
     readonly outputs: readonly [];
     readonly stateMutability: "nonpayable";
     readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly name: "_amount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "_depositKey";
+        readonly type: "bytes";
+    }];
+    readonly name: "queueBTC";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
 }, {
     readonly inputs: readonly [{
         readonly name: "";
@@ -2096,4 +2264,4 @@ declare function getExtDataHash(extData: ExtDataInput): bigint;
  */
 declare function shuffle<T>(array: T[]): T[];
 
-export { ADDRESSES, type BuildTransferProofOptions, type BuildWithdrawProofOptions, CIRCUIT_CONFIG, type DepositTxOptions, ENTRY_ABI, ERC20_ABI, type EncryptedMessage, type ExtData, type ExtDataInput, FIELD_SIZE, Keypair, MERKLE_TREE_HEIGHT, type NetworkAddresses, POOL_ABI, POOL_CONFIG, type PendingDeposit, type PoolConfig, type PrepareTransactionParams, type PrivateBalanceResult, type ProgressCallback, type ProofArgs, type ProofBuildResult, type ProofInput, QUEUE_ABI, type QueueBalanceResult, type RegisterTxOptions, RelayError, type RelayErrorResponse, type RelayExtData, type RelayMetadata, type RelayPool, type RelayProofArgs, type RelayRequest, type RelayResponse, type RelayType, type SubmitRelayOptions, type Token, type TransactionData, type TransactionResult, type TransferResult, Utxo, type UtxoInfo, type UtxoParams, type UtxoSelectionResult, type WithdrawResult, buildApproveUSDCTx, buildDepositETHTx, buildDepositTx, buildDepositUSDCTx, buildMerkleTree, buildRegisterTx, buildTransferProof, buildWithdrawProof, checkRecipientRegistration, checkRelayHealth, getAddresses, getExtDataHash, getMerklePath, getPrivateBalance, getQueueBalance, getRelayInfo, getRelayUrl, mergeUtxos, packEncryptedMessage, poseidonHash, poseidonHash2, prepareTransaction, prove, randomBN, selectCircuit, selectUtxosForWithdraw, shuffle, submitRelay, toBuffer, toFixedHex, transfer, unpackEncryptedMessage, withdraw };
+export { ADDRESSES, type BuildTransferProofOptions, type BuildWithdrawProofOptions, CIRCUIT_CONFIG, type DepositTxOptions, ENTRY_ABI, ERC20_ABI, type EncryptedMessage, type ExtData, type ExtDataInput, FIELD_SIZE, Keypair, MERKLE_TREE_HEIGHT, type MessageSigner, type NetworkAddresses, POOL_ABI, POOL_CONFIG, type PendingDeposit, type PoolConfig, type PrepareTransactionParams, type PrivateBalanceResult, type ProgressCallback, type ProofArgs, type ProofBuildResult, type ProofInput, QUEUE_ABI, type QueueBalanceResult, type RegisterTxOptions, RelayError, type RelayErrorResponse, type RelayExtData, type RelayMetadata, type RelayPool, type RelayProofArgs, type RelayRequest, type RelayResponse, type RelayType, type SubmitRelayOptions, type Token, type TransactionData, type TransactionResult, type TransferResult, Utxo, type UtxoInfo, type UtxoParams, type UtxoSelectionResult, VEIL_SIGNED_MESSAGE, type WithdrawResult, buildApproveCBBTCTx, buildApproveUSDCTx, buildChangeDepositKeyTx, buildDepositCBBTCTx, buildDepositETHTx, buildDepositTx, buildDepositUSDCTx, buildMerkleTree, buildRegisterTx, buildTransferProof, buildWithdrawProof, checkRecipientRegistration, checkRelayHealth, getAddresses, getExtDataHash, getMerklePath, getPoolAddress, getPrivateBalance, getQueueAddress, getQueueBalance, getRelayInfo, getRelayUrl, mergeUtxos, packEncryptedMessage, poseidonHash, poseidonHash2, prepareTransaction, prove, randomBN, selectCircuit, selectUtxosForWithdraw, shuffle, submitRelay, toBuffer, toFixedHex, transfer, unpackEncryptedMessage, withdraw };