@circle-fin/usdckit 0.22.0 → 0.23.0

package/dist/esm/chains/ARC_TESTNET.d.ts

@@ -0,0 +1,180 @@
+export declare const chain: {
+    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;
+};

package/dist/esm/chains/ARC_TESTNET.js

@@ -0,0 +1,54 @@
+// 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 { defineChain, erc20Abi } from 'viem';
+// REF: https://github.com/wevm/viem/blob/00dd2e80646f6253c6d09be6acb7f57b7373737f/src/chains/definitions/arcTestnet.ts#L5
+const arcTestnet = /*#__PURE__*/ defineChain({
+    id: 5042002,
+    name: 'Arc Testnet',
+    nativeCurrency: {
+        name: 'USDC',
+        symbol: 'USDC',
+        decimals: 18,
+    },
+    rpcUrls: {
+        default: {
+            http: [
+                'https://rpc.testnet.arc.network',
+                'https://rpc.quicknode.testnet.arc.network',
+                'https://rpc.blockdaemon.testnet.arc.network',
+            ],
+            webSocket: ['wss://rpc.testnet.arc.network', 'wss://rpc.quicknode.testnet.arc.network'],
+        },
+    },
+    blockExplorers: {
+        default: {
+            name: 'ArcScan',
+            url: 'https://testnet.arcscan.app',
+            apiUrl: 'https://testnet.arcscan.app/api',
+        },
+    },
+    contracts: {
+        multicall3: {
+            address: '0xcA11bde05977b3631167028862bE2a173976CA11',
+            blockCreated: 0,
+        },
+    },
+    testnet: true,
+});
+export const chain = defineChain({
+    ...arcTestnet,
+    blockchainId: 'ARC-TESTNET',
+    blockchainVm: 'EVM',
+    contracts: {
+        ...arcTestnet.contracts,
+        USDC: { address: '0x3600000000000000000000000000000000000000', abi: erc20Abi, read: { decimals: () => 6 } },
+    },
+});

package/dist/esm/chains/index.d.ts

@@ -1,5 +1,6 @@
 export { chain as ARB } from './ARB.js';
 export { chain as ARB_SEPOLIA } from './ARB_SEPOLIA.js';
+export { chain as ARC_TESTNET } from './ARC_TESTNET.js';
 export { chain as AVAX } from './AVAX.js';
 export { chain as AVAX_FUJI } from './AVAX_FUJI.js';
 export { chain as ETH } from './ETH.js';

package/dist/esm/chains/index.js

@@ -10,6 +10,7 @@
 // prohibited without the express written permission of Circle Internet Group, Inc.
 export { chain as ARB } from './ARB.js';
 export { chain as ARB_SEPOLIA } from './ARB_SEPOLIA.js';
+export { chain as ARC_TESTNET } from './ARC_TESTNET.js';
 export { chain as AVAX } from './AVAX.js';
 export { chain as AVAX_FUJI } from './AVAX_FUJI.js';
 export { chain as ETH } from './ETH.js';

package/dist/esm/chains/index.test.js

@@ -14,6 +14,7 @@ describe.concurrent('chains', () => {
     test.each([
         'ARB_SEPOLIA',
         'ARB',
+        'ARC_TESTNET',
         'AVAX_FUJI',
         'AVAX',
         'BASE_SEPOLIA',

package/dist/esm/extractChain.d.ts

@@ -355,6 +355,185 @@ declare const SUPPORTED_CHAINS: ({
     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/extractChain.test.js

@@ -10,7 +10,7 @@
 // prohibited without the express written permission of Circle Internet Group, Inc.
 import { arbitrumSepolia, avalancheFuji, sepolia, polygonAmoy, unichainSepolia, mainnet, arbitrum, avalanche, polygon, unichain, base, baseSepolia, nearTestnet, near, optimismSepolia, optimism, } from 'viem/chains';
 import { describe, test, expect } from 'vitest';
-import { ARB, ARB_SEPOLIA, AVAX, AVAX_FUJI, BASE_SEPOLIA, BASE, ETH, ETH_SEPOLIA, MATIC, MATIC_AMOY, NEAR_TESTNET, NEAR, OP_SEPOLIA, OP, UNI, UNI_SEPOLIA, } from './chains/index.js';
+import { ARB, ARB_SEPOLIA, ARC_TESTNET, AVAX, AVAX_FUJI, BASE_SEPOLIA, BASE, ETH, ETH_SEPOLIA, MATIC, MATIC_AMOY, NEAR_TESTNET, NEAR, OP_SEPOLIA, OP, UNI, UNI_SEPOLIA, } from './chains/index.js';
 import { extractChain } from './extractChain.js';
 describe.concurrent('extractChain', () => {
     test.each([
@@ -18,6 +18,7 @@ describe.concurrent('extractChain', () => {
         [arbitrumSepolia, ARB_SEPOLIA],
         [ARB, ARB],
         [arbitrum, ARB],
+        [ARC_TESTNET, ARC_TESTNET],
         [AVAX_FUJI, AVAX_FUJI],
         [avalancheFuji, AVAX_FUJI],
         [AVAX, AVAX],

package/dist/esm/metadata.js

@@ -11,4 +11,4 @@
 /**
  * The current semantic version of the SDK
  */
-export const VERSION = `${'0.22.0' || '0.0.0'}`;
+export const VERSION = `${'0.23.0' || '0.0.0'}`;

package/dist/esm/providers/circle-wallets/actions/createAccount.d.ts

@@ -427,6 +427,185 @@ export declare function createAccount(client: ExtendedViemClient, params?: Creat
         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/actions/createAccount.js

@@ -60,6 +60,9 @@ export async function createAccount(client, params = {}) {
     let wallet;
     if (account !== undefined) {
         const accountChain = extractChain(account.chain) ?? raise(new UnsupportedChainError());
+        if (chain.blockchainId === 'ARC-TESTNET') {
+            raise(new UnsupportedChainError());
+        }
         const [sourceWallet] = await listWallets({
             address: account.address,
             blockchain: accountChain.blockchainId,