@circle-fin/usdckit 0.22.0 → 0.23.1

package/dist/esm/providers/circle-wallets/index.d.ts

@@ -357,6 +357,185 @@ export declare const SUPPORTED_CHAINS: readonly [{
     readonly blockchainId: "ARB-SEPOLIA";
     readonly blockchainVm: "EVM";
     readonly formatters?: undefined | undefined;
+}, {
+    blockExplorers: {
+        readonly default: {
+            readonly name: "ArcScan";
+            readonly url: "https://testnet.arcscan.app";
+            readonly apiUrl: "https://testnet.arcscan.app/api";
+        };
+    };
+    blockTime?: number | undefined | undefined;
+    contracts: {
+        readonly USDC: {
+            readonly address: "0x3600000000000000000000000000000000000000";
+            readonly 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";
+                }];
+            }];
+            readonly read: {
+                readonly decimals: () => 6;
+            };
+        };
+        readonly multicall3: {
+            readonly address: "0xcA11bde05977b3631167028862bE2a173976CA11";
+            readonly blockCreated: 0;
+        };
+    };
+    ensTlds?: readonly string[] | undefined;
+    id: 5042002;
+    name: "Arc Testnet";
+    nativeCurrency: {
+        readonly name: "USDC";
+        readonly symbol: "USDC";
+        readonly decimals: 18;
+    };
+    experimental_preconfirmationTime?: number | undefined | undefined;
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://rpc.testnet.arc.network", "https://rpc.quicknode.testnet.arc.network", "https://rpc.blockdaemon.testnet.arc.network"];
+            readonly webSocket: readonly ["wss://rpc.testnet.arc.network", "wss://rpc.quicknode.testnet.arc.network"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    testnet: true;
+    custom?: Record<string, unknown> | undefined;
+    fees?: import("viem").ChainFees<undefined> | undefined;
+    serializers?: import("viem").ChainSerializers<undefined, import("viem").TransactionSerializable> | undefined;
+    readonly blockchainId: "ARC-TESTNET";
+    readonly blockchainVm: "EVM";
+    readonly formatters?: undefined;
 }, {
     blockExplorers: {
         readonly default: {
@@ -5423,6 +5602,185 @@ export declare const SUPPORTED_CHAINS_FAUCET: readonly [{
     readonly blockchainId: "ARB-SEPOLIA";
     readonly blockchainVm: "EVM";
     readonly formatters?: undefined | undefined;
+}, {
+    blockExplorers: {
+        readonly default: {
+            readonly name: "ArcScan";
+            readonly url: "https://testnet.arcscan.app";
+            readonly apiUrl: "https://testnet.arcscan.app/api";
+        };
+    };
+    blockTime?: number | undefined | undefined;
+    contracts: {
+        readonly USDC: {
+            readonly address: "0x3600000000000000000000000000000000000000";
+            readonly 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";
+                }];
+            }];
+            readonly read: {
+                readonly decimals: () => 6;
+            };
+        };
+        readonly multicall3: {
+            readonly address: "0xcA11bde05977b3631167028862bE2a173976CA11";
+            readonly blockCreated: 0;
+        };
+    };
+    ensTlds?: readonly string[] | undefined;
+    id: 5042002;
+    name: "Arc Testnet";
+    nativeCurrency: {
+        readonly name: "USDC";
+        readonly symbol: "USDC";
+        readonly decimals: 18;
+    };
+    experimental_preconfirmationTime?: number | undefined | undefined;
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://rpc.testnet.arc.network", "https://rpc.quicknode.testnet.arc.network", "https://rpc.blockdaemon.testnet.arc.network"];
+            readonly webSocket: readonly ["wss://rpc.testnet.arc.network", "wss://rpc.quicknode.testnet.arc.network"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    testnet: true;
+    custom?: Record<string, unknown> | undefined;
+    fees?: import("viem").ChainFees<undefined> | undefined;
+    serializers?: import("viem").ChainSerializers<undefined, import("viem").TransactionSerializable> | undefined;
+    readonly blockchainId: "ARC-TESTNET";
+    readonly blockchainVm: "EVM";
+    readonly formatters?: undefined;
 }, {
     blockExplorers: {
         readonly default: {

package/dist/esm/providers/circle-wallets/index.js

@@ -8,7 +8,7 @@
 // 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 { ARB, ARB_SEPOLIA, AVAX, AVAX_FUJI, BASE, BASE_SEPOLIA, ETH, ETH_SEPOLIA, MATIC, MATIC_AMOY, OP, OP_SEPOLIA, UNI, UNI_SEPOLIA, } from '../../chains/index.js';
+import { ARB, ARB_SEPOLIA, ARC_TESTNET, AVAX, AVAX_FUJI, BASE, BASE_SEPOLIA, ETH, ETH_SEPOLIA, MATIC, MATIC_AMOY, OP, OP_SEPOLIA, UNI, UNI_SEPOLIA, } from '../../chains/index.js';
 import { UnsupportedChainError } from '../../errors/index.js';
 import { extractChain as _extractChain } from '../../extractChain.js';
 import { raise } from '../../utils/raise.js';
@@ -17,6 +17,7 @@ export const DEFAULT_WALLET_SET_NAME = 'default';
 export const SUPPORTED_CHAINS = [
     ARB,
     ARB_SEPOLIA,
+    ARC_TESTNET,
     AVAX,
     AVAX_FUJI,
     BASE,
@@ -32,6 +33,7 @@ export const SUPPORTED_CHAINS = [
 ];
 export const SUPPORTED_CHAINS_FAUCET = [
     ARB_SEPOLIA,
+    ARC_TESTNET,
     AVAX_FUJI,
     BASE_SEPOLIA,
     ETH_SEPOLIA,

package/dist/esm/providers/circle-wallets/transports/index.d.ts

@@ -228,6 +228,8 @@ export declare class Provider extends BaseProvider {
             gasPrice?: string;
             baseFee?: string;
             networkFee?: string;
+            networkFeeRaw?: string;
+            l1Fee?: string;
         } | undefined;
         medium: {
             gasLimit: `${number}` | "" | undefined;
@@ -236,6 +238,8 @@ export declare class Provider extends BaseProvider {
             gasPrice?: string;
             baseFee?: string;
             networkFee?: string;
+            networkFeeRaw?: string;
+            l1Fee?: string;
         } | undefined;
         low: {
             gasLimit: `${number}` | "" | undefined;
@@ -244,6 +248,8 @@ export declare class Provider extends BaseProvider {
             gasPrice?: string;
             baseFee?: string;
             networkFee?: string;
+            networkFeeRaw?: string;
+            l1Fee?: string;
         } | undefined;
         callGasLimit?: string;
         verificationGasLimit?: string;
@@ -274,6 +280,8 @@ export declare class Provider extends BaseProvider {
             gasPrice?: string;
             baseFee?: string;
             networkFee?: string;
+            networkFeeRaw?: string;
+            l1Fee?: string;
         } | undefined;
         medium: {
             gasLimit: `${number}` | "" | undefined;
@@ -282,6 +290,8 @@ export declare class Provider extends BaseProvider {
             gasPrice?: string;
             baseFee?: string;
             networkFee?: string;
+            networkFeeRaw?: string;
+            l1Fee?: string;
         } | undefined;
         low: {
             gasLimit: `${number}` | "" | undefined;
@@ -290,6 +300,8 @@ export declare class Provider extends BaseProvider {
             gasPrice?: string;
             baseFee?: string;
             networkFee?: string;
+            networkFeeRaw?: string;
+            l1Fee?: string;
         } | undefined;
         callGasLimit?: string;
         verificationGasLimit?: string;

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

@@ -1,4 +1,4 @@
-import type { Chain } from '../chains.js';
+import type { Chain } from '../chains/index.js';
 import type { Transport } from 'viem';
 export interface TransportFactoryParams {
     /** Required chain ID for the transport */

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

@@ -1,4 +1,4 @@
-import type { Chain } from '../chains.js';
+import type { Chain } from '../chains/index.js';
 import type { CustomWalletClient } from '../client.js';
 import type { TransportFactoryParams } from './createConfig.js';
 import type { Transport } from 'viem';

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

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

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

@@ -53,8 +53,8 @@ export declare function getContract(params: GetContractInput): {
     };
     getEvents: {
         [x: string]: (...parameters: [options?: {
-            blockHash?: `0x${string}` | undefined;
             strict?: boolean | undefined;
+            blockHash?: `0x${string}` | undefined;
             fromBlock?: bigint | import("viem").BlockTag | undefined;
             toBlock?: bigint | import("viem").BlockTag | undefined;
         } | undefined] | [args?: readonly unknown[] | {
@@ -71,8 +71,8 @@ export declare function getContract(params: GetContractInput): {
             batch?: undefined;
             pollingInterval?: undefined;
         } | undefined, options?: {
-            blockHash?: `0x${string}` | undefined;
             strict?: boolean | undefined;
+            blockHash?: `0x${string}` | undefined;
             fromBlock?: bigint | import("viem").BlockTag | undefined;
             toBlock?: bigint | import("viem").BlockTag | undefined;
         } | undefined]) => Promise<import("viem").GetContractEventsReturnType<Abi, string>>;
@@ -150,8 +150,8 @@ export declare function getContract(params: GetContractInput): {
     };
     getEvents: {
         [x: string]: (...parameters: [options?: {
-            blockHash?: `0x${string}` | undefined;
             strict?: boolean | undefined;
+            blockHash?: `0x${string}` | undefined;
             fromBlock?: bigint | import("viem").BlockTag | undefined;
             toBlock?: bigint | import("viem").BlockTag | undefined;
         } | undefined] | [args?: readonly unknown[] | {
@@ -168,8 +168,8 @@ export declare function getContract(params: GetContractInput): {
             batch?: undefined;
             pollingInterval?: undefined;
         } | undefined, options?: {
-            blockHash?: `0x${string}` | undefined;
             strict?: boolean | undefined;
+            blockHash?: `0x${string}` | undefined;
             fromBlock?: bigint | import("viem").BlockTag | undefined;
             toBlock?: bigint | import("viem").BlockTag | undefined;
         } | undefined]) => Promise<import("viem").GetContractEventsReturnType<Abi, string>>;
@@ -250,8 +250,8 @@ export declare function getContract(params: GetContractInput): {
     };
     getEvents: {
         [x: string]: (...parameters: [options?: {
-            blockHash?: `0x${string}` | undefined;
             strict?: boolean | undefined;
+            blockHash?: `0x${string}` | undefined;
             fromBlock?: bigint | import("viem").BlockTag | undefined;
             toBlock?: bigint | import("viem").BlockTag | undefined;
         } | undefined] | [args?: readonly unknown[] | {
@@ -268,8 +268,8 @@ export declare function getContract(params: GetContractInput): {
             batch?: undefined;
             pollingInterval?: undefined;
         } | undefined, options?: {
-            blockHash?: `0x${string}` | undefined;
             strict?: boolean | undefined;
+            blockHash?: `0x${string}` | undefined;
             fromBlock?: bigint | import("viem").BlockTag | undefined;
             toBlock?: bigint | import("viem").BlockTag | undefined;
         } | undefined]) => Promise<import("viem").GetContractEventsReturnType<Abi, string>>;
@@ -347,8 +347,8 @@ export declare function getContract(params: GetContractInput): {
     };
     getEvents: {
         [x: string]: (...parameters: [options?: {
-            blockHash?: `0x${string}` | undefined;
             strict?: boolean | undefined;
+            blockHash?: `0x${string}` | undefined;
             fromBlock?: bigint | import("viem").BlockTag | undefined;
             toBlock?: bigint | import("viem").BlockTag | undefined;
         } | undefined] | [args?: readonly unknown[] | {
@@ -365,8 +365,8 @@ export declare function getContract(params: GetContractInput): {
             batch?: undefined;
             pollingInterval?: undefined;
         } | undefined, options?: {
-            blockHash?: `0x${string}` | undefined;
             strict?: boolean | undefined;
+            blockHash?: `0x${string}` | undefined;
             fromBlock?: bigint | import("viem").BlockTag | undefined;
             toBlock?: bigint | import("viem").BlockTag | undefined;
         } | undefined]) => Promise<import("viem").GetContractEventsReturnType<Abi, string>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@circle-fin/usdckit",
-  "version": "0.22.0",
+  "version": "0.23.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/circlefin/w3s-node-sdk.git"
@@ -12,8 +12,8 @@
     "packages/*"
   ],
   "dependencies": {
-    "@circle-fin/developer-controlled-wallets": "^8.4.1",
-    "@circle-fin/smart-contract-platform": "^8.4.1",
+    "@circle-fin/developer-controlled-wallets": "^9.2.0",
+    "@circle-fin/smart-contract-platform": "^9.2.0",
     "@inquirer/prompts": "^7.5.3",
     "@solana-program/token": "^0.5.1",
     "@solana-program/token-2022": "^0.4.2",
@@ -107,5 +107,6 @@
     "generate:embed-metadata": "node ./scripts/embed-metadata.mjs",
     "precommit:install": "lefthook install",
     "prepack": "npm run build"
-  }
+  },
+  "packageManager": "npm@10.8.2"
 }

package/dist/cjs/chains.d.ts

@@ -1,2 +0,0 @@
-import type * as chains from './chains/index.js';
-export type Chain = (typeof chains)[keyof typeof chains];

package/dist/cjs/chains.js

@@ -1,12 +0,0 @@
-"use strict";
-// 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.
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/esm/chains.d.ts

@@ -1,2 +0,0 @@
-import type * as chains from './chains/index.js';
-export type Chain = (typeof chains)[keyof typeof chains];

package/dist/esm/chains.js

@@ -1,11 +0,0 @@
-// 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.
-export {};