@awarizon/web3 1.0.2 → 1.1.1

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { Chain, WalletClient, Address, Abi, PublicClient, Hex } from 'viem';
 export { Abi, Address, Chain, Hash, TransactionReceipt, WalletClient } from 'viem';
-import { WalletEngine, CreatedWallet, ImportedWalletFromMnemonic, ImportedWalletFromPrivateKey, ExternalWalletClient } from '@awarizon/wallet-engine';
-export { ChainSwitchError, InvalidMnemonicError, InvalidPrivateKeyError, WalletEngine, WalletNotConnectedError } from '@awarizon/wallet-engine';
+import { WalletEngine, CreatedWallet, ImportedWalletFromMnemonic, ImportedWalletFromPrivateKey, ConnectorInfo, ExternalWalletClient, EIP1193Provider, SignTypedDataParams, WalletChangeEvent, ChainChangeEvent } from '@awarizon/wallet-engine';
+export { ChainChangeEvent, ChainMismatchError, ChainSwitchError, ConnectorInfo, CreatedWallet, EIP1193Provider, ImportedWalletFromMnemonic, ImportedWalletFromPrivateKey, InvalidMnemonicError, InvalidPrivateKeyError, SignTypedDataParams, WalletChangeEvent, WalletEngine, WalletNotConnectedError } from '@awarizon/wallet-engine';
 import { TransactionResult } from '@awarizon/tx-engine';
 export { ContractExecutionError, GasEstimationError, SimulationError, TransactionEngine, TransactionResult, TransactionTimeoutError } from '@awarizon/tx-engine';
 export { DuplicateFunctionError, InvalidABIError, UnsupportedABIItemError, generateAllMethodSignatures, generateMethodSignature, isPayableFunction, isWriteFunction, parseABI } from '@awarizon/abi-engine';
@@ -34,6 +34,12 @@ interface AwarizonConfig {
      * Override for local development or staging environments.
      */
     baseUrl?: string;
+    /**
+     * When true, the SDK automatically requests a chain switch on the external
+     * wallet before every write if the wallet is on the wrong network.
+     * Only affects external wallets (wagmi, RainbowKit, EIP-1193).
+     */
+    autoSwitchChain?: boolean;
 }
 interface ContractConfig<TAbi extends Abi = Abi> {
     /** The deployed contract address */
@@ -76,6 +82,545 @@ interface SDKWalletInfo {
     address: Address;
     chain: Chain;
     isExternal: boolean;
+    /** Name of the connector if an external wallet is active, e.g. "MetaMask" */
+    connectorName?: string;
+}
+interface ContractRegistryEntry {
+    address: Address;
+    abi: Abi;
+}
+
+declare const ERC20_ABI: readonly [{
+    readonly type: "event";
+    readonly name: "Approval";
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly name: "value";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "Transfer";
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly name: "from";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly name: "value";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "allowance";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "approve";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "balanceOf";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "decimals";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "uint8";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "name";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "string";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "symbol";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "string";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "totalSupply";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "transfer";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "recipient";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "transferFrom";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "sender";
+        readonly type: "address";
+    }, {
+        readonly name: "recipient";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+}];
+interface Erc20Contract {
+    name(): Promise<string>;
+    symbol(): Promise<string>;
+    decimals(): Promise<number>;
+    totalSupply(): Promise<bigint>;
+    balanceOf(owner: Address): Promise<bigint>;
+    allowance(owner: Address, spender: Address): Promise<bigint>;
+    transfer(to: Address, amount: bigint): Promise<TransactionResult>;
+    transferFrom(from: Address, to: Address, amount: bigint): Promise<TransactionResult>;
+    approve(spender: Address, amount: bigint): Promise<TransactionResult>;
+    on: ContractInstance['on'];
+    estimateGas: ContractInstance['estimateGas'];
+    readonly _address: Address;
+    readonly _abi: Abi;
+}
+declare const ERC721_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "name";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "string";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "symbol";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "string";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "tokenURI";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "tokenId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "string";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "totalSupply";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "ownerOf";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "tokenId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "address";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "balanceOf";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "getApproved";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "tokenId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "address";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "isApprovedForAll";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly name: "operator";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "transferFrom";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "from";
+        readonly type: "address";
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "tokenId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "safeTransferFrom";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "from";
+        readonly type: "address";
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "tokenId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "approve";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "tokenId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "setApprovalForAll";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "operator";
+        readonly type: "address";
+    }, {
+        readonly name: "approved";
+        readonly type: "bool";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "event";
+    readonly name: "Transfer";
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly name: "from";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly name: "tokenId";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "Approval";
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly name: "approved";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly name: "tokenId";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "ApprovalForAll";
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly name: "operator";
+        readonly type: "address";
+    }, {
+        readonly name: "approved";
+        readonly type: "bool";
+    }];
+}];
+interface Erc721Contract {
+    name(): Promise<string>;
+    symbol(): Promise<string>;
+    tokenURI(tokenId: bigint): Promise<string>;
+    totalSupply(): Promise<bigint>;
+    ownerOf(tokenId: bigint): Promise<Address>;
+    balanceOf(owner: Address): Promise<bigint>;
+    getApproved(tokenId: bigint): Promise<Address>;
+    isApprovedForAll(owner: Address, operator: Address): Promise<boolean>;
+    transferFrom(from: Address, to: Address, tokenId: bigint): Promise<TransactionResult>;
+    safeTransferFrom(from: Address, to: Address, tokenId: bigint): Promise<TransactionResult>;
+    approve(to: Address, tokenId: bigint): Promise<TransactionResult>;
+    setApprovalForAll(operator: Address, approved: boolean): Promise<TransactionResult>;
+    on: ContractInstance['on'];
+    estimateGas: ContractInstance['estimateGas'];
+    readonly _address: Address;
+    readonly _abi: Abi;
+}
+declare const ERC1155_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "uri";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "id";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "string";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "balanceOf";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }, {
+        readonly name: "id";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "balanceOfBatch";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "accounts";
+        readonly type: "address[]";
+    }, {
+        readonly name: "ids";
+        readonly type: "uint256[]";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256[]";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "isApprovedForAll";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }, {
+        readonly name: "operator";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "setApprovalForAll";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "operator";
+        readonly type: "address";
+    }, {
+        readonly name: "approved";
+        readonly type: "bool";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "safeTransferFrom";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "from";
+        readonly type: "address";
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "id";
+        readonly type: "uint256";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "data";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "safeBatchTransferFrom";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "from";
+        readonly type: "address";
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "ids";
+        readonly type: "uint256[]";
+    }, {
+        readonly name: "amounts";
+        readonly type: "uint256[]";
+    }, {
+        readonly name: "data";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "event";
+    readonly name: "TransferSingle";
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly name: "operator";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly name: "from";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "id";
+        readonly type: "uint256";
+    }, {
+        readonly name: "value";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "TransferBatch";
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly name: "operator";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly name: "from";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "ids";
+        readonly type: "uint256[]";
+    }, {
+        readonly name: "values";
+        readonly type: "uint256[]";
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "ApprovalForAll";
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly name: "account";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly name: "operator";
+        readonly type: "address";
+    }, {
+        readonly name: "approved";
+        readonly type: "bool";
+    }];
+}];
+interface Erc1155Contract {
+    uri(id: bigint): Promise<string>;
+    balanceOf(account: Address, id: bigint): Promise<bigint>;
+    balanceOfBatch(accounts: Address[], ids: bigint[]): Promise<bigint[]>;
+    isApprovedForAll(account: Address, operator: Address): Promise<boolean>;
+    setApprovalForAll(operator: Address, approved: boolean): Promise<TransactionResult>;
+    safeTransferFrom(from: Address, to: Address, id: bigint, amount: bigint, data: `0x${string}`): Promise<TransactionResult>;
+    safeBatchTransferFrom(from: Address, to: Address, ids: bigint[], amounts: bigint[], data: `0x${string}`): Promise<TransactionResult>;
+    on: ContractInstance['on'];
+    estimateGas: ContractInstance['estimateGas'];
+    readonly _address: Address;
+    readonly _abi: Abi;
 }
 
 declare class NetworkMismatchError extends Error {
@@ -124,10 +669,26 @@ declare class WalletProxy {
     isConnected(): boolean;
     hasExternalWallet(): boolean;
     hasInternalWallet(): boolean;
-    connectExternal(c: ExternalWalletClient): void;
+    getConnectorInfo(): ConnectorInfo;
+    connectExternal(c: ExternalWalletClient, info?: {
+        name?: string;
+        icon?: string;
+    }): void;
     disconnectExternal(): void;
     disconnect(): void;
     switchChain(chain: Chain): Promise<void>;
+    connectEIP1193(provider: EIP1193Provider, info?: {
+        name?: string;
+        icon?: string;
+    }): Promise<void>;
+    signMessage(message: string | {
+        raw: Hex | Uint8Array;
+    }): Promise<Hex>;
+    signTypedData(params: SignTypedDataParams): Promise<Hex>;
+    getChainId(): Promise<number>;
+    isChainMismatch(): Promise<boolean>;
+    onWalletChange(cb: (event: WalletChangeEvent) => void): () => void;
+    onChainChange(cb: (event: ChainChangeEvent) => void): () => void;
 }
 /**
  * Primary entry point for the Awarizon Web3 SDK.
@@ -155,11 +716,91 @@ declare class AwarizonWeb3 {
     private readonly _txEngine;
     private readonly _telemetry;
     private _contractCache;
+    private _registry;
     constructor(config: AwarizonConfig);
-    connectWallet(walletClient: WalletClient): this;
+    /**
+     * Connect any viem WalletClient (wagmi, RainbowKit, custom).
+     * Optionally pass connector metadata to display in the UI.
+     *
+     * @example
+     * awarizon.connectWallet(walletClient, { name: "MetaMask" })
+     */
+    connectWallet(walletClient: WalletClient, connectorInfo?: {
+        name?: string;
+        icon?: string;
+    }): this;
+    /**
+     * Connect directly from a raw EIP-1193 provider without needing wagmi.
+     * Works with window.ethereum, WalletConnect v2, and any EIP-1193 object.
+     *
+     * @example
+     * await awarizon.connectEIP1193Provider(window.ethereum, { name: "MetaMask" })
+     */
+    connectEIP1193Provider(provider: EIP1193Provider, connectorInfo?: {
+        name?: string;
+        icon?: string;
+    }): Promise<this>;
     disconnectWallet(): this;
     switchChain(chain: Chain | string): Promise<this>;
     getWalletInfo(): SDKWalletInfo;
+    /**
+     * Sign a plain text or raw-bytes message.
+     * Use for Sign-In with Ethereum (SIWE) and off-chain authorization.
+     *
+     * @example
+     * const sig = await awarizon.signMessage("Hello, Awarizon!")
+     */
+    signMessage(message: string | {
+        raw: Hex | Uint8Array;
+    }): Promise<Hex>;
+    /**
+     * Sign EIP-712 typed structured data (permit2, SIWE, Seaport orders, etc.).
+     *
+     * @example
+     * const sig = await awarizon.signTypedData({
+     *   domain: { name: "MyApp", version: "1", chainId: 8453 },
+     *   types:  { Transfer: [{ name: "to", type: "address" }, { name: "amount", type: "uint256" }] },
+     *   primaryType: "Transfer",
+     *   message: { to: "0x...", amount: "1000000" },
+     * })
+     */
+    signTypedData(params: SignTypedDataParams): Promise<Hex>;
+    /**
+     * Returns the chain ID the active wallet is currently on.
+     * For external wallets this may differ from the SDK's configured chain.
+     */
+    getChainId(): Promise<number>;
+    /**
+     * Returns true when the external wallet is on a different chain than the SDK.
+     * Use this to show a "wrong network" banner in your UI.
+     *
+     * @example
+     * if (await awarizon.isChainMismatch()) {
+     *   alert("Please switch to Base in your wallet")
+     * }
+     */
+    isChainMismatch(): Promise<boolean>;
+    /**
+     * Returns metadata about the currently active connector.
+     * Useful for displaying "Connected via MetaMask" in the UI.
+     */
+    getConnectorInfo(): ConnectorInfo;
+    /**
+     * Subscribe to wallet changes (connect, disconnect, account switch).
+     * Returns an unsubscribe function — call it on cleanup.
+     *
+     * @example
+     * const unsub = awarizon.onWalletChange(({ address, type, name }) => {
+     *   console.log("Wallet changed:", address, type, name)
+     * })
+     * unsub() // stop listening
+     */
+    onWalletChange(cb: (event: WalletChangeEvent) => void): () => void;
+    /**
+     * Subscribe to chain changes (switchChain calls).
+     * Returns an unsubscribe function.
+     */
+    onChainChange(cb: (event: ChainChangeEvent) => void): () => void;
     /**
      * Load a deployed contract and return a fully typed, ABI-powered instance.
      * Validates the API key on the first call — subsequent calls are instant.
@@ -247,6 +888,75 @@ declare class AwarizonWeb3 {
         method: string;
         args?: unknown[];
     }>): Promise<unknown[]>;
+    /**
+     * Load an ERC-20 token with fully typed methods — no ABI import needed.
+     *
+     * ```ts
+     * const token = await awarizon.erc20("0x...")
+     * const balance = await token.balanceOf(userAddress)
+     * const symbol  = await token.symbol()
+     * await token.transfer(recipient, 100n)
+     * ```
+     */
+    erc20(address: Address): Promise<Erc20Contract>;
+    /**
+     * Load an ERC-721 NFT contract with fully typed methods — no ABI import needed.
+     *
+     * ```ts
+     * const nft   = await awarizon.erc721("0x...")
+     * const owner = await nft.ownerOf(1n)
+     * const uri   = await nft.tokenURI(1n)
+     * await nft.transferFrom(from, to, 1n)
+     * ```
+     */
+    erc721(address: Address): Promise<Erc721Contract>;
+    /**
+     * Load an ERC-1155 multi-token contract with fully typed methods — no ABI import needed.
+     *
+     * ```ts
+     * const items   = await awarizon.erc1155("0x...")
+     * const balance = await items.balanceOf(userAddress, 42n)
+     * const uri     = await items.uri(42n)
+     * await items.safeTransferFrom(from, to, 42n, 1n, "0x")
+     * ```
+     */
+    erc1155(address: Address): Promise<Erc1155Contract>;
+    /**
+     * Register a contract under a human-readable name.
+     * After registering, use `awarizon.use(name)` anywhere instead of repeating
+     * address + ABI every time.
+     *
+     * ```ts
+     * awarizon.register("USDC",  { address: "0x...", abi: erc20Abi })
+     * awarizon.register("Vault", { address: "0x...", abi: vaultAbi })
+     *
+     * const usdc  = await awarizon.use("USDC")
+     * const vault = await awarizon.use("Vault")
+     * ```
+     */
+    register(name: string, config: ContractRegistryEntry): this;
+    /**
+     * Retrieve a previously registered contract by name.
+     * Throws a descriptive error if the name was never registered.
+     *
+     * ```ts
+     * const usdc = await awarizon.use("USDC")
+     * await usdc.transfer(recipient, 100n)
+     * ```
+     */
+    use(name: string): Promise<ContractInstance>;
+    /**
+     * Remove a registered contract from the registry.
+     *
+     * ```ts
+     * awarizon.unregister("USDC")
+     * ```
+     */
+    unregister(name: string): this;
+    /**
+     * Return all registered contract names.
+     */
+    registeredContracts(): string[];
     get chainId(): number;
     get isConnected(): boolean;
     /**
@@ -327,4 +1037,4 @@ declare class TelemetryClient {
     private _flushBeacon;
 }
 
-export { ApiKeyRequiredError, type AwarizonConfig, AwarizonWeb3, CHAINS, type ContractConfig, type ContractInstance, ContractNotLoadedError, type EventUnsubscribe, InvalidApiKeyError, NetworkMismatchError, type PayableOptions, ProviderError, type SDKWalletInfo, TelemetryClient, type TelemetryEvent, type TelemetryEventType, UnsupportedChainError, getSupportedChainIds, resolveChain };
+export { ApiKeyRequiredError, type AwarizonConfig, AwarizonWeb3, CHAINS, type ContractConfig, type ContractInstance, ContractNotLoadedError, type ContractRegistryEntry, ERC1155_ABI, ERC20_ABI, ERC721_ABI, type Erc1155Contract, type Erc20Contract, type Erc721Contract, type EventUnsubscribe, InvalidApiKeyError, NetworkMismatchError, type PayableOptions, ProviderError, type SDKWalletInfo, TelemetryClient, type TelemetryEvent, type TelemetryEventType, UnsupportedChainError, getSupportedChainIds, resolveChain };