@circle-fin/usdckit 0.17.1 → 0.19.0

package/dist/esm/providers/uniswap/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/providers/uniswap/index.ts"],"names":[],"mappings":"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CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qCAA73S,CAAC;;;;;;;;;;;;2BAAgrB,CAAC;+BAAgG,CAAC;;;;;;;;;;;;;;;;;;;;;;wBAAw5B,CAAC;gCAAyD,CAAC;;;0BAAuI,CAAC;oBAA+B,CAAC;;;;;;;;;;;;;;;;;;0BAA8xB,CAAC;iCAA0D,CAAC;mCAA4D,CAAC;uBAAgD,CAAC;uBAA6C,CAAC;;;gCAA2H,CAAC;4BAAqD,CAAC;oCAA6D,CAAC;0BAAmD,CAAC;oBAA6C,CAAC;0BAAmD,CAAC;;;;;;;;;;;;;;;;;;iCAAmyB,CAAC;mCAA4D,CAAC;;;;gCAA6J,CAAC;4BAAqD,CAAC;oCAA6D,CAAC;0BAAmD,CAAC;oBAA6C,CAAC;0BAAmD,CAAC;;;;;;;;;;;;;;;;;;iCAAmyB,CAAC;mCAA4D,CAAC;;;wBAAmH,CAAC;gCAAyD,CAAC;;;0BAAuI,CAAC;oBAA6C,CAAC;0BAAmD,CAAC;;;;;;;;;;;;;;;;;;iCAAmyB,CAAC;;;;wBAAiM,CAAC;;;;0BAAiL,CAAC;oBAA6C,CAAC;0BAAmD,CAAC;;;;;;;;;;;;;;;;;;;mCAA03B,CAAC;;;wBAAmH,CAAC;gCAAyD,CAAC;;;0BAAuI,CAAC;oBAA6C,CAAC;0BAAmD,CAAC;;;;;;;4BAAsR,CAAC;2BAAiD,CAAC;;;;;;;;;;oBAAsgB,CAAC;;;;;;;;;;;;;;;;;;;EALpqW,CAAA;AAEjF,OAAO,EAAE,IAAI,EAAE,CAAA;AACf,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA"}

package/dist/esm/providers/uniswap/index.js

@@ -0,0 +1,18 @@
+// Copyright (c) 2025, Circle Internet Group, Inc.
+// All rights reserved.
+//
+// Circle Internet Group, Inc. CONFIDENTIAL
+//
+// This file includes unpublished proprietary source code of Circle Internet
+// Group, Inc. The copyright notice above does not
+// evidence any actual or intended publication of such source code. Disclosure
+// of this source code or any related proprietary information is strictly
+// prohibited without the express written permission of Circle Internet Group, Inc.
+import * as abis from './abis/index.js';
+import { BASE_SEPOLIA, ETH_SEPOLIA, UNI_SEPOLIA } from './chains/index.js';
+export const NAME = 'uniswap';
+export const SUPPORTED_CHAINS = [BASE_SEPOLIA, ETH_SEPOLIA, UNI_SEPOLIA];
+export { abis };
+export * from './actions/index.js';
+export * from './extractChain.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/providers/uniswap/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/providers/uniswap/index.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,uBAAuB;AACvB,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,8EAA8E;AAC9E,yEAAyE;AACzE,mFAAmF;AAEnF,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAA;AACvC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE1E,MAAM,CAAC,MAAM,IAAI,GAAG,SAAS,CAAA;AAC7B,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,YAAY,EAAE,WAAW,EAAE,WAAW,CAAU,CAAA;AAEjF,OAAO,EAAE,IAAI,EAAE,CAAA;AACf,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA"}

package/dist/esm/types.d.ts

@@ -1,31 +1,20 @@
 import type { Actions as CoreActions } from './actions/index.js';
+import type { Actions as CircleWalletsActions } from './providers/circle-wallets/actions/index.js';
+import type { EIP1474Methods as CircleWalletsMethods } from './providers/circle-wallets/transports/index.js';
 import type { Actions as CrossChainTransferProtocolActions } from './providers/cross-chain-transfer-protocol/actions/index.js';
-import type { EIP1474Methods as CrossChainTransferMethods } from './providers/cross-chain-transfer-protocol/provider.js';
-import type { Actions as DeveloperControlledWalletActions } from './providers/developer-controlled-wallets/actions/index.js';
-import type { EIP1474Methods as DeveloperControlledWalletMethods } from './providers/developer-controlled-wallets/provider.js';
-import type { Actions as FaucetActions } from './providers/faucet/index.js';
-import type { EIP1474Methods as FaucetMethods } from './providers/faucet/provider.js';
-import type { Actions as SmartContractPlatformActions } from './providers/smart-contract-platform/actions/index.js';
-import type { EIP1474Methods as SmartContractPlatformMethods } from './providers/smart-contract-platform/provider.js';
+import type { EIP1474Methods as CrossChainTransferMethods } from './providers/cross-chain-transfer-protocol/transports/index.js';
 import type { Logger } from 'pino';
-import type { Account as _Account, Assign, Chain, Client, EIP1474Methods, Prettify, PublicActions, Transport, WalletActions } from 'viem';
-export type Merge<T, U> = Prettify<Assign<T, U>>;
-export type { Address, GetContractReturnType as Contract, FeeValuesEIP1559 } from 'viem';
+import type { Account as _Account, Chain, Client, EIP1474Methods, PublicActions, Transport, WalletActions } from 'viem';
+export type { Address, Chain, ChainContract, GetContractReturnType as Contract, FeeValuesEIP1559, Assign as Merge, } from 'viem';
 export type Account = _Account & {
     chain?: Chain;
 };
-export type ExtendedEIP1474Methods = [
-    ...DeveloperControlledWalletMethods,
-    ...SmartContractPlatformMethods,
-    ...FaucetMethods,
-    ...CrossChainTransferMethods,
-    ...EIP1474Methods
-];
+export type ExtendedEIP1474Methods = [...CircleWalletsMethods, ...CrossChainTransferMethods, ...EIP1474Methods];
 export type ExtendedViemClient<transport extends Transport = Transport, chain extends Chain = Chain> = Client<transport, chain, Account, ExtendedEIP1474Methods>;
 export type CircleClient = Omit<Client, 'chain'> & {
     logger: Logger;
     chain: NonNullable<Client['chain']>;
-} & PublicActions & WalletActions & DeveloperControlledWalletActions & SmartContractPlatformActions & FaucetActions & CrossChainTransferProtocolActions & CoreActions;
+} & PublicActions & WalletActions & CircleWalletsActions & CrossChainTransferProtocolActions & CoreActions;
 /**
  * The primary denomination of a blockchain’s currency
  *
@@ -34,19 +23,12 @@ export type CircleClient = Omit<Client, 'chain'> & {
  */
 export type NativeUnits = `${number}`;
 /**
- * The smallest indivisible unit of a cryptocurrency
+ * The smallest indivisible unit of a blockchain’s currency
  *
  * @example
  * const unit: BaseUnits = 1n; // 0.000000000000000001 ETH
  */
 export type BaseUnits = bigint;
-/**
- * Interface for objects that can be converted to string representations.
- */
-export interface Stringifyable {
-    toString(): string;
-    toJSON(): string;
-}
 export type ControlFlowOptions = {
     /**
      * Caller provided Abort signal to cancel long running tasks

package/dist/esm/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChE,OAAO,KAAK,EAAE,OAAO,IAAI,iCAAiC,EAAE,MAAM,4DAA4D,CAAA;AAC9H,OAAO,KAAK,EAAE,cAAc,IAAI,yBAAyB,EAAE,MAAM,uDAAuD,CAAA;AACxH,OAAO,KAAK,EAAE,OAAO,IAAI,gCAAgC,EAAE,MAAM,2DAA2D,CAAA;AAC5H,OAAO,KAAK,EAAE,cAAc,IAAI,gCAAgC,EAAE,MAAM,sDAAsD,CAAA;AAC9H,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAC3E,OAAO,KAAK,EAAE,cAAc,IAAI,aAAa,EAAE,MAAM,gCAAgC,CAAA;AACrF,OAAO,KAAK,EAAE,OAAO,IAAI,4BAA4B,EAAE,MAAM,sDAAsD,CAAA;AACnH,OAAO,KAAK,EAAE,cAAc,IAAI,4BAA4B,EAAE,MAAM,iDAAiD,CAAA;AACrH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAClC,OAAO,KAAK,EACV,OAAO,IAAI,QAAQ,EACnB,MAAM,EACN,KAAK,EACL,MAAM,EACN,cAAc,EACd,QAAQ,EACR,aAAa,EACb,SAAS,EACT,aAAa,EACd,MAAM,MAAM,CAAA;AAEb,MAAM,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;AAEhD,YAAY,EAAE,OAAO,EAAE,qBAAqB,IAAI,QAAQ,EAAE,gBAAgB,EAAE,MAAM,MAAM,CAAA;AAExF,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG;IAAE,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAAA;AAGlD,MAAM,MAAM,sBAAsB,GAAG;IACnC,GAAG,gCAAgC;IACnC,GAAG,4BAA4B;IAC/B,GAAG,aAAa;IAChB,GAAG,yBAAyB;IAC5B,GAAG,cAAc;CAClB,CAAA;AAED,MAAM,MAAM,kBAAkB,CAAC,SAAS,SAAS,SAAS,GAAG,SAAS,EAAE,KAAK,SAAS,KAAK,GAAG,KAAK,IAAI,MAAM,CAC3G,SAAS,EACT,KAAK,EACL,OAAO,EACP,sBAAsB,CACvB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACjD,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;CACpC,GAAG,aAAa,GACf,aAAa,GACb,gCAAgC,GAChC,4BAA4B,GAC5B,aAAa,GACb,iCAAiC,GACjC,WAAW,CAAA;AAEb;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,GAAG,MAAM,EAAE,CAAA;AAGrC;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAA;AAE9B;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,IAAI,MAAM,CAAA;IAClB,MAAM,IAAI,MAAM,CAAA;CACjB;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;;;;;;;;;;;;;;;;;;;SAqBK;IACL,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChE,OAAO,KAAK,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,6CAA6C,CAAA;AAClG,OAAO,KAAK,EAAE,cAAc,IAAI,oBAAoB,EAAE,MAAM,gDAAgD,CAAA;AAC5G,OAAO,KAAK,EAAE,OAAO,IAAI,iCAAiC,EAAE,MAAM,4DAA4D,CAAA;AAC9H,OAAO,KAAK,EAAE,cAAc,IAAI,yBAAyB,EAAE,MAAM,+DAA+D,CAAA;AAChI,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAClC,OAAO,KAAK,EAAE,OAAO,IAAI,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,MAAM,CAAA;AAEvH,YAAY,EACV,OAAO,EACP,KAAK,EACL,aAAa,EACb,qBAAqB,IAAI,QAAQ,EACjC,gBAAgB,EAChB,MAAM,IAAI,KAAK,GAChB,MAAM,MAAM,CAAA;AAEb,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG;IAAE,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAAA;AAGlD,MAAM,MAAM,sBAAsB,GAAG,CAAC,GAAG,oBAAoB,EAAE,GAAG,yBAAyB,EAAE,GAAG,cAAc,CAAC,CAAA;AAE/G,MAAM,MAAM,kBAAkB,CAAC,SAAS,SAAS,SAAS,GAAG,SAAS,EAAE,KAAK,SAAS,KAAK,GAAG,KAAK,IAAI,MAAM,CAC3G,SAAS,EACT,KAAK,EACL,OAAO,EACP,sBAAsB,CACvB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACjD,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;CACpC,GAAG,aAAa,GACf,aAAa,GACb,oBAAoB,GACpB,iCAAiC,GACjC,WAAW,CAAA;AAEb;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,GAAG,MAAM,EAAE,CAAA;AAGrC;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAA;AAE9B,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;;;;;;;;;;;;;;;;;;;SAqBK;IACL,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB,CAAA"}

package/dist/esm/utils/getChainContractByAddress.d.ts

@@ -1,5 +1,4 @@
-import type { Address } from '../types.js';
-import type { Chain, ChainContract } from 'viem';
+import type { Address, Chain, ChainContract } from '../types.js';
 /**
  * Retrieves the contract associated with a given address from the specified chain.
  *

package/dist/esm/utils/getChainContractByAddress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getChainContractByAddress.d.ts","sourceRoot":"","sources":["../../../src/utils/getChainContractByAddress.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAA;AAEhD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAG,aAAa,CAYvF"}
+{"version":3,"file":"getChainContractByAddress.d.ts","sourceRoot":"","sources":["../../../src/utils/getChainContractByAddress.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAG,aAAa,CAYvF"}

package/dist/esm/utils/getChainContractByAddress.js.map

@@ -1 +1 @@
-{"version":3,"file":"getChainContractByAddress.js","sourceRoot":"","sources":["../../../src/utils/getChainContractByAddress.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,uBAAuB;AACvB,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,8EAA8E;AAC9E,yEAAyE;AACzE,mFAAmF;AAEnF,OAAO,EAAE,2BAA2B,EAAE,MAAM,MAAM,CAAA;AAKlD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAY,EAAE,OAAgB;IACtE,MAAM,cAAc,GAAG,KAAK,EAAE,SAA0C,CAAA;IACxE,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,KAAK,OAAO,CAAC,CAAA;IAEpG,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,2BAA2B,CAAC;YACpC,KAAK;YACL,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;SAC5B,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,aAAa,CAAA;AACtB,CAAC"}
+{"version":3,"file":"getChainContractByAddress.js","sourceRoot":"","sources":["../../../src/utils/getChainContractByAddress.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,uBAAuB;AACvB,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,8EAA8E;AAC9E,yEAAyE;AACzE,mFAAmF;AAEnF,OAAO,EAAE,2BAA2B,EAAE,MAAM,MAAM,CAAA;AAIlD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAY,EAAE,OAAgB;IACtE,MAAM,cAAc,GAAG,KAAK,EAAE,SAA0C,CAAA;IACxE,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,KAAK,OAAO,CAAC,CAAA;IAEpG,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,2BAA2B,CAAC;YACpC,KAAK;YACL,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;SAC5B,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,aAAa,CAAA;AACtB,CAAC"}

package/dist/esm/utils/getContract.d.ts

@@ -0,0 +1,421 @@
+import type { Address, Chain } from '../types.js';
+import type { Abi, Client } from 'viem';
+export type GetContractInput = {
+    address: Address;
+    abi?: Abi;
+} & ({
+    chain: Chain;
+    client?: never;
+} | {
+    chain?: never;
+    client: Client;
+});
+/**
+ * Retrieves a contract instance using the provided address, ABI, and client.
+ *
+ * @param params - The input parameters for retrieving the contract.
+ * @throws {Error} Throws an error if the ABI is not provided and cannot be found in the chain's contracts.
+ * @returns The contract instance.
+ */
+export declare function getContract(params: GetContractInput): {
+    read: {
+        [x: string]: (...parameters: [options?: import("viem").Prettify<import("viem").UnionOmit<import("viem").ReadContractParameters<Abi, string, readonly unknown[]>, "address" | "abi" | "functionName" | "args">> | undefined] | [args: readonly unknown[], options?: import("viem").Prettify<import("viem").UnionOmit<import("viem").ReadContractParameters<Abi, string, readonly unknown[]>, "address" | "abi" | "functionName" | "args">> | undefined]) => Promise<import("viem").ReadContractReturnType>;
+    };
+    estimateGas: {
+        [x: string]: (...parameters: [options: import("viem").Prettify<import("viem").UnionOmit<import("viem").EstimateContractGasParameters<Abi, string, readonly unknown[], Chain | undefined>, "address" | "abi" | "functionName" | "args">>] | [args: readonly unknown[], options: import("viem").Prettify<import("viem").UnionOmit<import("viem").EstimateContractGasParameters<Abi, string, readonly unknown[], Chain | undefined>, "address" | "abi" | "functionName" | "args">>]) => Promise<import("viem").EstimateContractGasReturnType>;
+    } & {
+        [x: string]: (...parameters: [options: import("viem").Prettify<import("viem").UnionOmit<import("viem").EstimateContractGasParameters<Abi, string, readonly unknown[], Chain | undefined>, "address" | "abi" | "functionName" | "args">>] | [args: readonly unknown[], options: import("viem").Prettify<import("viem").UnionOmit<import("viem").EstimateContractGasParameters<Abi, string, readonly unknown[], Chain | undefined>, "address" | "abi" | "functionName" | "args">>]) => Promise<import("viem").EstimateContractGasReturnType>;
+    };
+    simulate: {
+        [x: string]: <chainOverride extends Chain | undefined = undefined, accountOverride extends import("viem").Account | Address | undefined = undefined>(...parameters: [options?: Omit<import("viem").SimulateContractParameters<Abi, string, readonly unknown[], Chain | undefined, chainOverride, accountOverride>, "address" | "abi" | "functionName" | "args"> | undefined] | [args: readonly unknown[], options?: Omit<import("viem").SimulateContractParameters<Abi, string, readonly unknown[], Chain | undefined, chainOverride, accountOverride>, "address" | "abi" | "functionName" | "args"> | undefined]) => Promise<import("viem").SimulateContractReturnType>;
+    };
+    createEventFilter: {
+        [x: string]: <strict extends boolean | undefined = undefined>(...parameters: [options?: ({
+            fromBlock?: bigint | import("viem").BlockTag | undefined;
+            toBlock?: bigint | import("viem").BlockTag | undefined;
+        } & {
+            strict?: strict | undefined;
+        }) | undefined] | [args: readonly unknown[] | {
+            [x: string]: unknown;
+            address?: undefined;
+            abi?: undefined;
+            eventName?: undefined;
+            fromBlock?: undefined;
+            strict?: undefined;
+            toBlock?: undefined;
+            args?: undefined;
+        }, options?: ({
+            fromBlock?: bigint | import("viem").BlockTag | undefined;
+            toBlock?: bigint | import("viem").BlockTag | undefined;
+        } & {
+            strict?: strict | undefined;
+        }) | undefined]) => Promise<import("viem").CreateContractEventFilterReturnType>;
+    };
+    getEvents: {
+        [x: string]: (...parameters: [options?: {
+            blockHash?: `0x${string}` | undefined;
+            strict?: boolean | undefined;
+            fromBlock?: bigint | import("viem").BlockTag | undefined;
+            toBlock?: bigint | import("viem").BlockTag | undefined;
+        } | undefined] | [args?: readonly unknown[] | {
+            [x: string]: unknown;
+            address?: undefined;
+            abi?: undefined;
+            args?: undefined;
+            eventName?: undefined;
+            fromBlock?: undefined;
+            onError?: undefined;
+            onLogs?: undefined;
+            strict?: undefined;
+            poll?: undefined;
+            batch?: undefined;
+            pollingInterval?: undefined;
+        } | undefined, options?: {
+            blockHash?: `0x${string}` | undefined;
+            strict?: boolean | undefined;
+            fromBlock?: bigint | import("viem").BlockTag | undefined;
+            toBlock?: bigint | import("viem").BlockTag | undefined;
+        } | undefined]) => Promise<import("viem").GetContractEventsReturnType<Abi, string>>;
+    };
+    watchEvent: {
+        [x: string]: (...parameters: [options?: {
+            batch?: boolean | undefined | undefined;
+            pollingInterval?: number | undefined | undefined;
+            strict?: boolean | undefined;
+            fromBlock?: bigint | undefined;
+            onError?: ((error: Error) => void) | undefined | undefined;
+            onLogs: import("viem").WatchContractEventOnLogsFn<Abi, string, undefined>;
+            poll?: true | undefined | undefined;
+        } | undefined] | [args: readonly unknown[] | {
+            [x: string]: unknown;
+            address?: undefined;
+            abi?: undefined;
+            args?: undefined;
+            eventName?: undefined;
+            fromBlock?: undefined;
+            onError?: undefined;
+            onLogs?: undefined;
+            strict?: undefined;
+            poll?: undefined;
+            batch?: undefined;
+            pollingInterval?: undefined;
+        }, options?: {
+            batch?: boolean | undefined | undefined;
+            pollingInterval?: number | undefined | undefined;
+            strict?: boolean | undefined;
+            fromBlock?: bigint | undefined;
+            onError?: ((error: Error) => void) | undefined | undefined;
+            onLogs: import("viem").WatchContractEventOnLogsFn<Abi, string, undefined>;
+            poll?: true | undefined | undefined;
+        } | undefined]) => import("viem").WatchContractEventReturnType;
+    };
+    write: {
+        [x: string]: <chainOverride extends Chain | undefined, options extends import("viem").UnionOmit<import("viem").WriteContractParameters<Abi, string, readonly unknown[], Chain | undefined, import("viem").Account | undefined, chainOverride>, "address" | "abi" | "functionName" | "args"> extends infer T ? { [K in keyof T]: import("viem").UnionOmit<import("viem").WriteContractParameters<Abi, string, readonly unknown[], Chain | undefined, import("viem").Account | undefined, chainOverride>, "address" | "abi" | "functionName" | "args">[K]; } : never, Rest extends unknown[] = [options: options]>(...parameters: Rest | [args: readonly unknown[], ...parameters: Rest]) => Promise<import("viem").WriteContractReturnType>;
+    };
+    address: `0x${string}`;
+    abi: Abi;
+} | {
+    read: {
+        [x: string]: (...parameters: [options?: import("viem").Prettify<import("viem").UnionOmit<import("viem").ReadContractParameters<Abi, string, readonly unknown[]>, "address" | "abi" | "functionName" | "args">> | undefined] | [args: readonly unknown[], options?: import("viem").Prettify<import("viem").UnionOmit<import("viem").ReadContractParameters<Abi, string, readonly unknown[]>, "address" | "abi" | "functionName" | "args">> | undefined]) => Promise<import("viem").ReadContractReturnType>;
+    };
+    estimateGas: {
+        [x: string]: (...parameters: [options: import("viem").Prettify<import("viem").UnionOmit<import("viem").EstimateContractGasParameters<Abi, string, readonly unknown[], Chain | undefined>, "address" | "abi" | "functionName" | "args">>] | [args: readonly unknown[], options: import("viem").Prettify<import("viem").UnionOmit<import("viem").EstimateContractGasParameters<Abi, string, readonly unknown[], Chain | undefined>, "address" | "abi" | "functionName" | "args">>]) => Promise<import("viem").EstimateContractGasReturnType>;
+    } & {
+        [x: string]: (...parameters: [options?: import("viem").Prettify<import("viem").UnionOmit<import("viem").EstimateContractGasParameters<Abi, string, readonly unknown[], Chain>, "address" | "abi" | "functionName" | "args">> | undefined] | [args: readonly unknown[], options?: import("viem").Prettify<import("viem").UnionOmit<import("viem").EstimateContractGasParameters<Abi, string, readonly unknown[], Chain>, "address" | "abi" | "functionName" | "args">> | undefined]) => Promise<import("viem").EstimateContractGasReturnType>;
+    };
+    simulate: {
+        [x: string]: <chainOverride extends Chain | undefined = undefined, accountOverride extends import("viem").Account | Address | undefined = undefined>(...parameters: [options?: Omit<import("viem").SimulateContractParameters<Abi, string, readonly unknown[], Chain | undefined, chainOverride, accountOverride>, "address" | "abi" | "functionName" | "args"> | undefined] | [args: readonly unknown[], options?: Omit<import("viem").SimulateContractParameters<Abi, string, readonly unknown[], Chain | undefined, chainOverride, accountOverride>, "address" | "abi" | "functionName" | "args"> | undefined]) => Promise<import("viem").SimulateContractReturnType>;
+    };
+    createEventFilter: {
+        [x: string]: <strict extends boolean | undefined = undefined>(...parameters: [options?: ({
+            fromBlock?: bigint | import("viem").BlockTag | undefined;
+            toBlock?: bigint | import("viem").BlockTag | undefined;
+        } & {
+            strict?: strict | undefined;
+        }) | undefined] | [args: readonly unknown[] | {
+            [x: string]: unknown;
+            address?: undefined;
+            abi?: undefined;
+            eventName?: undefined;
+            fromBlock?: undefined;
+            strict?: undefined;
+            toBlock?: undefined;
+            args?: undefined;
+        }, options?: ({
+            fromBlock?: bigint | import("viem").BlockTag | undefined;
+            toBlock?: bigint | import("viem").BlockTag | undefined;
+        } & {
+            strict?: strict | undefined;
+        }) | undefined]) => Promise<import("viem").CreateContractEventFilterReturnType>;
+    };
+    getEvents: {
+        [x: string]: (...parameters: [options?: {
+            blockHash?: `0x${string}` | undefined;
+            strict?: boolean | undefined;
+            fromBlock?: bigint | import("viem").BlockTag | undefined;
+            toBlock?: bigint | import("viem").BlockTag | undefined;
+        } | undefined] | [args?: readonly unknown[] | {
+            [x: string]: unknown;
+            address?: undefined;
+            abi?: undefined;
+            args?: undefined;
+            eventName?: undefined;
+            fromBlock?: undefined;
+            onError?: undefined;
+            onLogs?: undefined;
+            strict?: undefined;
+            poll?: undefined;
+            batch?: undefined;
+            pollingInterval?: undefined;
+        } | undefined, options?: {
+            blockHash?: `0x${string}` | undefined;
+            strict?: boolean | undefined;
+            fromBlock?: bigint | import("viem").BlockTag | undefined;
+            toBlock?: bigint | import("viem").BlockTag | undefined;
+        } | undefined]) => Promise<import("viem").GetContractEventsReturnType<Abi, string>>;
+    };
+    watchEvent: {
+        [x: string]: (...parameters: [options?: {
+            batch?: boolean | undefined | undefined;
+            pollingInterval?: number | undefined | undefined;
+            strict?: boolean | undefined;
+            fromBlock?: bigint | undefined;
+            onError?: ((error: Error) => void) | undefined | undefined;
+            onLogs: import("viem").WatchContractEventOnLogsFn<Abi, string, undefined>;
+            poll?: true | undefined | undefined;
+        } | undefined] | [args: readonly unknown[] | {
+            [x: string]: unknown;
+            address?: undefined;
+            abi?: undefined;
+            args?: undefined;
+            eventName?: undefined;
+            fromBlock?: undefined;
+            onError?: undefined;
+            onLogs?: undefined;
+            strict?: undefined;
+            poll?: undefined;
+            batch?: undefined;
+            pollingInterval?: undefined;
+        }, options?: {
+            batch?: boolean | undefined | undefined;
+            pollingInterval?: number | undefined | undefined;
+            strict?: boolean | undefined;
+            fromBlock?: bigint | undefined;
+            onError?: ((error: Error) => void) | undefined | undefined;
+            onLogs: import("viem").WatchContractEventOnLogsFn<Abi, string, undefined>;
+            poll?: true | undefined | undefined;
+        } | undefined]) => import("viem").WatchContractEventReturnType;
+    };
+    write: {
+        [x: string]: <chainOverride extends Chain | undefined, options extends import("viem").UnionOmit<import("viem").WriteContractParameters<Abi, string, readonly unknown[], Chain, {
+            address: `0x${string}`;
+            type: "json-rpc";
+        }, chainOverride>, "address" | "abi" | "functionName" | "args"> extends infer T ? { [K in keyof T]: import("viem").UnionOmit<import("viem").WriteContractParameters<Abi, string, readonly unknown[], Chain, {
+            address: `0x${string}`;
+            type: "json-rpc";
+        }, chainOverride>, "address" | "abi" | "functionName" | "args">[K]; } : never, Rest extends unknown[] = [options?: options | undefined]>(...parameters: Rest | [args: readonly unknown[], ...parameters: Rest]) => Promise<import("viem").WriteContractReturnType>;
+    };
+    address: `0x${string}`;
+    abi: Abi;
+} | {
+    read: {
+        [x: string]: (...parameters: [options?: import("viem").Prettify<import("viem").UnionOmit<import("viem").ReadContractParameters<Abi, string, readonly unknown[]>, "address" | "abi" | "functionName" | "args">> | undefined] | [args: readonly unknown[], options?: import("viem").Prettify<import("viem").UnionOmit<import("viem").ReadContractParameters<Abi, string, readonly unknown[]>, "address" | "abi" | "functionName" | "args">> | undefined]) => Promise<import("viem").ReadContractReturnType>;
+    };
+    estimateGas: {
+        [x: string]: (...parameters: [options: import("viem").Prettify<import("viem").UnionOmit<import("viem").EstimateContractGasParameters<Abi, string, readonly unknown[], Chain>, "address" | "abi" | "functionName" | "args">>] | [args: readonly unknown[], options: import("viem").Prettify<import("viem").UnionOmit<import("viem").EstimateContractGasParameters<Abi, string, readonly unknown[], Chain>, "address" | "abi" | "functionName" | "args">>]) => Promise<import("viem").EstimateContractGasReturnType>;
+    } & {
+        [x: string]: (...parameters: [options: import("viem").Prettify<import("viem").UnionOmit<import("viem").EstimateContractGasParameters<Abi, string, readonly unknown[], Chain | undefined>, "address" | "abi" | "functionName" | "args">>] | [args: readonly unknown[], options: import("viem").Prettify<import("viem").UnionOmit<import("viem").EstimateContractGasParameters<Abi, string, readonly unknown[], Chain | undefined>, "address" | "abi" | "functionName" | "args">>]) => Promise<import("viem").EstimateContractGasReturnType>;
+    };
+    simulate: {
+        [x: string]: <chainOverride extends Chain | undefined = undefined, accountOverride extends import("viem").Account | Address | undefined = undefined>(...parameters: [options?: Omit<import("viem").SimulateContractParameters<Abi, string, readonly unknown[], Chain, chainOverride, accountOverride>, "address" | "abi" | "functionName" | "args"> | undefined] | [args: readonly unknown[], options?: Omit<import("viem").SimulateContractParameters<Abi, string, readonly unknown[], Chain, chainOverride, accountOverride>, "address" | "abi" | "functionName" | "args"> | undefined]) => Promise<import("viem").SimulateContractReturnType>;
+    };
+    createEventFilter: {
+        [x: string]: <strict extends boolean | undefined = undefined>(...parameters: [options?: ({
+            fromBlock?: bigint | import("viem").BlockTag | undefined;
+            toBlock?: bigint | import("viem").BlockTag | undefined;
+        } & {
+            strict?: strict | undefined;
+        }) | undefined] | [args: readonly unknown[] | {
+            [x: string]: unknown;
+            address?: undefined;
+            abi?: undefined;
+            eventName?: undefined;
+            fromBlock?: undefined;
+            strict?: undefined;
+            toBlock?: undefined;
+            args?: undefined;
+        }, options?: ({
+            fromBlock?: bigint | import("viem").BlockTag | undefined;
+            toBlock?: bigint | import("viem").BlockTag | undefined;
+        } & {
+            strict?: strict | undefined;
+        }) | undefined]) => Promise<import("viem").CreateContractEventFilterReturnType>;
+    };
+    getEvents: {
+        [x: string]: (...parameters: [options?: {
+            blockHash?: `0x${string}` | undefined;
+            strict?: boolean | undefined;
+            fromBlock?: bigint | import("viem").BlockTag | undefined;
+            toBlock?: bigint | import("viem").BlockTag | undefined;
+        } | undefined] | [args?: readonly unknown[] | {
+            [x: string]: unknown;
+            address?: undefined;
+            abi?: undefined;
+            args?: undefined;
+            eventName?: undefined;
+            fromBlock?: undefined;
+            onError?: undefined;
+            onLogs?: undefined;
+            strict?: undefined;
+            poll?: undefined;
+            batch?: undefined;
+            pollingInterval?: undefined;
+        } | undefined, options?: {
+            blockHash?: `0x${string}` | undefined;
+            strict?: boolean | undefined;
+            fromBlock?: bigint | import("viem").BlockTag | undefined;
+            toBlock?: bigint | import("viem").BlockTag | undefined;
+        } | undefined]) => Promise<import("viem").GetContractEventsReturnType<Abi, string>>;
+    };
+    watchEvent: {
+        [x: string]: (...parameters: [options?: {
+            batch?: boolean | undefined | undefined;
+            pollingInterval?: number | undefined | undefined;
+            strict?: boolean | undefined;
+            fromBlock?: bigint | undefined;
+            onError?: ((error: Error) => void) | undefined | undefined;
+            onLogs: import("viem").WatchContractEventOnLogsFn<Abi, string, undefined>;
+            poll?: true | undefined | undefined;
+        } | undefined] | [args: readonly unknown[] | {
+            [x: string]: unknown;
+            address?: undefined;
+            abi?: undefined;
+            args?: undefined;
+            eventName?: undefined;
+            fromBlock?: undefined;
+            onError?: undefined;
+            onLogs?: undefined;
+            strict?: undefined;
+            poll?: undefined;
+            batch?: undefined;
+            pollingInterval?: undefined;
+        }, options?: {
+            batch?: boolean | undefined | undefined;
+            pollingInterval?: number | undefined | undefined;
+            strict?: boolean | undefined;
+            fromBlock?: bigint | undefined;
+            onError?: ((error: Error) => void) | undefined | undefined;
+            onLogs: import("viem").WatchContractEventOnLogsFn<Abi, string, undefined>;
+            poll?: true | undefined | undefined;
+        } | undefined]) => import("viem").WatchContractEventReturnType;
+    };
+    write: {
+        [x: string]: <chainOverride extends Chain | undefined, options extends import("viem").UnionOmit<import("viem").WriteContractParameters<Abi, string, readonly unknown[], Chain | undefined, import("viem").Account | undefined, chainOverride>, "address" | "abi" | "functionName" | "args"> extends infer T ? { [K in keyof T]: import("viem").UnionOmit<import("viem").WriteContractParameters<Abi, string, readonly unknown[], Chain | undefined, import("viem").Account | undefined, chainOverride>, "address" | "abi" | "functionName" | "args">[K]; } : never, Rest extends unknown[] = [options: options]>(...parameters: Rest | [args: readonly unknown[], ...parameters: Rest]) => Promise<import("viem").WriteContractReturnType>;
+    };
+    address: `0x${string}`;
+    abi: Abi;
+} | {
+    read: {
+        [x: string]: (...parameters: [options?: import("viem").Prettify<import("viem").UnionOmit<import("viem").ReadContractParameters<Abi, string, readonly unknown[]>, "address" | "abi" | "functionName" | "args">> | undefined] | [args: readonly unknown[], options?: import("viem").Prettify<import("viem").UnionOmit<import("viem").ReadContractParameters<Abi, string, readonly unknown[]>, "address" | "abi" | "functionName" | "args">> | undefined]) => Promise<import("viem").ReadContractReturnType>;
+    };
+    estimateGas: {
+        [x: string]: (...parameters: [options: import("viem").Prettify<import("viem").UnionOmit<import("viem").EstimateContractGasParameters<Abi, string, readonly unknown[], Chain>, "address" | "abi" | "functionName" | "args">>] | [args: readonly unknown[], options: import("viem").Prettify<import("viem").UnionOmit<import("viem").EstimateContractGasParameters<Abi, string, readonly unknown[], Chain>, "address" | "abi" | "functionName" | "args">>]) => Promise<import("viem").EstimateContractGasReturnType>;
+    } & {
+        [x: string]: (...parameters: [options?: import("viem").Prettify<import("viem").UnionOmit<import("viem").EstimateContractGasParameters<Abi, string, readonly unknown[], Chain>, "address" | "abi" | "functionName" | "args">> | undefined] | [args: readonly unknown[], options?: import("viem").Prettify<import("viem").UnionOmit<import("viem").EstimateContractGasParameters<Abi, string, readonly unknown[], Chain>, "address" | "abi" | "functionName" | "args">> | undefined]) => Promise<import("viem").EstimateContractGasReturnType>;
+    };
+    simulate: {
+        [x: string]: <chainOverride extends Chain | undefined = undefined, accountOverride extends import("viem").Account | Address | undefined = undefined>(...parameters: [options?: Omit<import("viem").SimulateContractParameters<Abi, string, readonly unknown[], Chain, chainOverride, accountOverride>, "address" | "abi" | "functionName" | "args"> | undefined] | [args: readonly unknown[], options?: Omit<import("viem").SimulateContractParameters<Abi, string, readonly unknown[], Chain, chainOverride, accountOverride>, "address" | "abi" | "functionName" | "args"> | undefined]) => Promise<import("viem").SimulateContractReturnType>;
+    };
+    createEventFilter: {
+        [x: string]: <strict extends boolean | undefined = undefined>(...parameters: [options?: ({
+            fromBlock?: bigint | import("viem").BlockTag | undefined;
+            toBlock?: bigint | import("viem").BlockTag | undefined;
+        } & {
+            strict?: strict | undefined;
+        }) | undefined] | [args: readonly unknown[] | {
+            [x: string]: unknown;
+            address?: undefined;
+            abi?: undefined;
+            eventName?: undefined;
+            fromBlock?: undefined;
+            strict?: undefined;
+            toBlock?: undefined;
+            args?: undefined;
+        }, options?: ({
+            fromBlock?: bigint | import("viem").BlockTag | undefined;
+            toBlock?: bigint | import("viem").BlockTag | undefined;
+        } & {
+            strict?: strict | undefined;
+        }) | undefined]) => Promise<import("viem").CreateContractEventFilterReturnType>;
+    };
+    getEvents: {
+        [x: string]: (...parameters: [options?: {
+            blockHash?: `0x${string}` | undefined;
+            strict?: boolean | undefined;
+            fromBlock?: bigint | import("viem").BlockTag | undefined;
+            toBlock?: bigint | import("viem").BlockTag | undefined;
+        } | undefined] | [args?: readonly unknown[] | {
+            [x: string]: unknown;
+            address?: undefined;
+            abi?: undefined;
+            args?: undefined;
+            eventName?: undefined;
+            fromBlock?: undefined;
+            onError?: undefined;
+            onLogs?: undefined;
+            strict?: undefined;
+            poll?: undefined;
+            batch?: undefined;
+            pollingInterval?: undefined;
+        } | undefined, options?: {
+            blockHash?: `0x${string}` | undefined;
+            strict?: boolean | undefined;
+            fromBlock?: bigint | import("viem").BlockTag | undefined;
+            toBlock?: bigint | import("viem").BlockTag | undefined;
+        } | undefined]) => Promise<import("viem").GetContractEventsReturnType<Abi, string>>;
+    };
+    watchEvent: {
+        [x: string]: (...parameters: [options?: {
+            batch?: boolean | undefined | undefined;
+            pollingInterval?: number | undefined | undefined;
+            strict?: boolean | undefined;
+            fromBlock?: bigint | undefined;
+            onError?: ((error: Error) => void) | undefined | undefined;
+            onLogs: import("viem").WatchContractEventOnLogsFn<Abi, string, undefined>;
+            poll?: true | undefined | undefined;
+        } | undefined] | [args: readonly unknown[] | {
+            [x: string]: unknown;
+            address?: undefined;
+            abi?: undefined;
+            args?: undefined;
+            eventName?: undefined;
+            fromBlock?: undefined;
+            onError?: undefined;
+            onLogs?: undefined;
+            strict?: undefined;
+            poll?: undefined;
+            batch?: undefined;
+            pollingInterval?: undefined;
+        }, options?: {
+            batch?: boolean | undefined | undefined;
+            pollingInterval?: number | undefined | undefined;
+            strict?: boolean | undefined;
+            fromBlock?: bigint | undefined;
+            onError?: ((error: Error) => void) | undefined | undefined;
+            onLogs: import("viem").WatchContractEventOnLogsFn<Abi, string, undefined>;
+            poll?: true | undefined | undefined;
+        } | undefined]) => import("viem").WatchContractEventReturnType;
+    };
+    write: {
+        [x: string]: <chainOverride extends Chain | undefined, options extends import("viem").UnionOmit<import("viem").WriteContractParameters<Abi, string, readonly unknown[], Chain, {
+            address: `0x${string}`;
+            type: "json-rpc";
+        }, chainOverride>, "address" | "abi" | "functionName" | "args"> extends infer T ? { [K in keyof T]: import("viem").UnionOmit<import("viem").WriteContractParameters<Abi, string, readonly unknown[], Chain, {
+            address: `0x${string}`;
+            type: "json-rpc";
+        }, chainOverride>, "address" | "abi" | "functionName" | "args">[K]; } : never, Rest extends unknown[] = [options?: options | undefined]>(...parameters: Rest | [args: readonly unknown[], ...parameters: Rest]) => Promise<import("viem").WriteContractReturnType>;
+    };
+    address: `0x${string}`;
+    abi: Abi;
+};
+//# sourceMappingURL=getContract.d.ts.map

package/dist/esm/utils/getContract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getContract.d.ts","sourceRoot":"","sources":["../../../src/utils/getContract.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAiB,MAAM,aAAa,CAAA;AAChE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAEvC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,GAAG,CAAA;CACV,GAAG,CACA;IACE,KAAK,EAAE,KAAK,CAAA;IACZ,MAAM,CAAC,EAAE,KAAK,CAAA;CACf,GACD;IACE,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf,CACJ,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BnD"}

package/dist/esm/utils/getContract.js

@@ -0,0 +1,39 @@
+// Copyright (c) 2025, Circle Internet Group, Inc.
+// All rights reserved.
+//
+// Circle Internet Group, Inc. CONFIDENTIAL
+//
+// This file includes unpublished proprietary source code of Circle Internet
+// Group, Inc. The copyright notice above does not
+// evidence any actual or intended publication of such source code. Disclosure
+// of this source code or any related proprietary information is strictly
+// prohibited without the express written permission of Circle Internet Group, Inc.
+import { createPublicClient, getContract as _getContract, http } from 'viem';
+/**
+ * Retrieves a contract instance using the provided address, ABI, and client.
+ *
+ * @param params - The input parameters for retrieving the contract.
+ * @throws {Error} Throws an error if the ABI is not provided and cannot be found in the chain's contracts.
+ * @returns The contract instance.
+ */
+export function getContract(params) {
+    const { address } = params;
+    let { abi } = params;
+    const client = params.client ??
+        createPublicClient({
+            chain: params.chain,
+            transport: http(),
+        });
+    const chain = client.chain;
+    // If ABI is not provided, attempt to default to the chain's contract ABI
+    if (abi === undefined && chain?.contracts !== undefined) {
+        const chainContract = Object.values(chain.contracts).find((contract) => contract !== undefined && contract.address === address);
+        // @ts-expect-error: Ignore ts(2339) for `abi` property
+        abi = chainContract?.abi;
+    }
+    if (abi === undefined) {
+        throw new Error(`No ABI provided for contract at ${address}`);
+    }
+    return _getContract({ address, abi, client });
+}
+//# sourceMappingURL=getContract.js.map

package/dist/esm/utils/getContract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getContract.js","sourceRoot":"","sources":["../../../src/utils/getContract.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,uBAAuB;AACvB,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,8EAA8E;AAC9E,yEAAyE;AACzE,mFAAmF;AAEnF,OAAO,EAAE,kBAAkB,EAAE,WAAW,IAAI,YAAY,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAmB5E;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,MAAwB;IAClD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAA;IAC1B,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,CAAA;IAEpB,MAAM,MAAM,GACV,MAAM,CAAC,MAAM;QACb,kBAAkB,CAAC;YACjB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,SAAS,EAAE,IAAI,EAAE;SAClB,CAAC,CAAA;IACJ,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAA;IAE1B,yEAAyE;IACzE,IAAI,GAAG,KAAK,SAAS,IAAI,KAAK,EAAE,SAAS,KAAK,SAAS,EAAE,CAAC;QACxD,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CACvD,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,KAAK,SAAS,IAAK,QAA0B,CAAC,OAAO,KAAK,OAAO,CAC3D,CAAA;QAE9B,uDAAuD;QACvD,GAAG,GAAG,aAAa,EAAE,GAAsB,CAAA;IAC7C,CAAC;IAED,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,mCAAmC,OAAO,EAAE,CAAC,CAAA;IAC/D,CAAC;IAED,OAAO,YAAY,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAA;AAC/C,CAAC"}

package/dist/esm/utils/getContract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getContract.test.d.ts","sourceRoot":"","sources":["../../../src/utils/getContract.test.ts"],"names":[],"mappings":""}