@circle-fin/usdckit 0.11.1

package/dist/esm/index.js

@@ -0,0 +1,77 @@
+// 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 { createClient as createViemClient, fallback, http, publicActions, walletActions, } from 'viem';
+import { actions as coreActions } from './actions/index.js';
+import { ETH_SEPOLIA } from './chains/index.js';
+import { onResponse } from './onResponse.js';
+import { actions as crossChainTransferProtocolActions, http as crossChainTransferProtocolTransport, } from './providers/cross-chain-transfer-protocol/index.js';
+import { actions as developerControlledWalletActions, http as developerControlledWalletsTransport, } from './providers/developer-controlled-wallets/index.js';
+import { actions as faucetActions, http as faucetTransport } from './providers/faucet/index.js';
+import { actions as smartContractsPlatformActions, http as smartContractsPlatformTransport, } from './providers/smart-contracts-platform/index.js';
+export * from './types.js';
+export { VERSION } from './metadata.js';
+export * from './errors/index.js';
+/**
+ * Creates a Circle client with the specified parameters.
+ *
+ * @param params - The parameters for creating the client
+ * @returns A configured Circle client instance
+ *
+ * @example
+ * Initialize a client with using the default chain
+ * ```typescript
+ * import { createClient } from '@circle-fin/usdckit'
+ *
+ * const client = createClient({
+ *   apiKey: 'your-api-key',
+ *   entitySecret: 'your-entity-secret',
+ * });
+ * ```
+ * @example
+ * Initialize a client with using `MATIC_SEPOLIA` chain
+ * ```typescript
+ * import { createClient } from '@circle-fin/usdckit'
+ * import { MATIC_SEPOLIA } from '@circle-fin/usdckit/chains'
+ *
+ * const client = createClient({
+ *   apiKey: 'your-api-key',
+ *   entitySecret: 'your-entity-secret',
+ *   chain: MATIC_SEPOLIA,
+ * });
+ * ```
+ */
+export function createCircleClient(params) {
+    const { apiKey, entitySecret, chain = ETH_SEPOLIA, baseUrl } = params;
+    const transport = fallback([
+        ...[
+            developerControlledWalletsTransport,
+            smartContractsPlatformTransport,
+            faucetTransport,
+            crossChainTransferProtocolTransport,
+        ].map((transport) => transport({ apiKey, entitySecret, baseUrl })),
+        http(),
+    ]);
+    const client = createViemClient({ chain, transport })
+        .extend(publicActions)
+        .extend(walletActions)
+        .extend(developerControlledWalletActions)
+        .extend(developerControlledWalletActions) // HACK: Re-extend to ensure method override
+        .extend(smartContractsPlatformActions)
+        .extend(smartContractsPlatformActions) // HACK: Re-extend to ensure method override
+        .extend(faucetActions)
+        .extend(crossChainTransferProtocolActions)
+        .extend(coreActions);
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-call
+    client.transport.onResponse(onResponse);
+    return client;
+}
+export { createCircleClient as createClient };
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/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,EAEL,YAAY,IAAI,gBAAgB,EAChC,QAAQ,EACR,IAAI,EACJ,aAAa,EACb,aAAa,GAEd,MAAM,MAAM,CAAA;AAEb,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EACL,OAAO,IAAI,iCAAiC,EAC5C,IAAI,IAAI,mCAAmC,GAC5C,MAAM,oDAAoD,CAAA;AAC3D,OAAO,EACL,OAAO,IAAI,gCAAgC,EAC3C,IAAI,IAAI,mCAAmC,GAC5C,MAAM,mDAAmD,CAAA;AAC1D,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,IAAI,IAAI,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAC/F,OAAO,EACL,OAAO,IAAI,6BAA6B,EACxC,IAAI,IAAI,+BAA+B,GACxC,MAAM,+CAA+C,CAAA;AAItD,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,cAAc,mBAAmB,CAAA;AAgBjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA0C;IAC3E,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,GAAG,WAAW,EAAE,OAAO,EAAE,GAAG,MAAM,CAAA;IAErE,MAAM,SAAS,GAAG,QAAQ,CAAC;QACzB,GAAG;YACD,mCAAmC;YACnC,+BAA+B;YAC/B,eAAe;YACf,mCAAmC;SACpC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,CAAC;QAClE,IAAI,EAAE;KACP,CAAC,CAAA;IAEF,MAAM,MAAM,GAAG,gBAAgB,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;SAClD,MAAM,CAAC,aAAa,CAAC;SACrB,MAAM,CAAC,aAAa,CAAC;SACrB,MAAM,CAAC,gCAAgC,CAAC;SACxC,MAAM,CAAC,gCAAgC,CAAC,CAAC,4CAA4C;SACrF,MAAM,CAAC,6BAA6B,CAAC;SACrC,MAAM,CAAC,6BAA6B,CAAC,CAAC,4CAA4C;SAClF,MAAM,CAAC,aAAa,CAAC;SACrB,MAAM,CAAC,iCAAiC,CAAC;SACzC,MAAM,CAAC,WAAW,CAA4B,CAAA;IAEjD,6DAA6D;IAC7D,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC,CAAA;IAEvC,OAAO,MAAM,CAAA;AACf,CAAC;AAED,OAAO,EAAE,kBAAkB,IAAI,YAAY,EAAE,CAAA"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/esm/index.test.d.ts.map

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

package/dist/esm/index.test.js

@@ -0,0 +1,22 @@
+// 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 { describe, it, expect } from 'vitest';
+import { createClient } from './index.js';
+describe('createClient', () => {
+    it('should create successfully', () => {
+        const client = createClient({
+            apiKey: 'key',
+            entitySecret: 'secret',
+        });
+        expect(client).toBeDefined();
+    });
+});
+//# sourceMappingURL=index.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../src/index.test.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,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEzC,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,MAAM,GAAG,YAAY,CAAC;YAC1B,MAAM,EAAE,KAAK;YACb,YAAY,EAAE,QAAQ;SACvB,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAA;IAC9B,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/esm/metadata.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The current semantic version of the SDK
+ */
+export declare const VERSION: string;
+//# sourceMappingURL=metadata.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/metadata.ts"],"names":[],"mappings":"AAWA;;GAEG;AACH,eAAO,MAAM,OAAO,QAAsC,CAAA"}

package/dist/esm/metadata.js

@@ -0,0 +1,15 @@
+// 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.
+/**
+ * The current semantic version of the SDK
+ */
+export const VERSION = `${'0.11.1' || '0.0.0'}`;
+//# sourceMappingURL=metadata.js.map

package/dist/esm/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../src/metadata.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,uBAAuB;AACvB,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,8EAA8E;AAC9E,yEAAyE;AACzE,mFAAmF;AAEnF;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,OAAO,EAAE,CAAA"}

package/dist/esm/onResponse.d.ts

@@ -0,0 +1,9 @@
+import type { Transport } from 'viem';
+export declare function onResponse({ method, params, response, error, transport, }: {
+    method: string;
+    params?: unknown[];
+    response?: unknown;
+    error?: Error;
+    transport: ReturnType<Transport>;
+}): void;
+//# sourceMappingURL=onResponse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"onResponse.d.ts","sourceRoot":"","sources":["../../src/onResponse.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AAGrC,wBAAgB,UAAU,CAAC,EACzB,MAAM,EACN,MAAW,EACX,QAAQ,EACR,KAAK,EACL,SAAS,GACV,EAAE;IACD,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,CAAA;CACjC,GAAG,IAAI,CAaP"}

package/dist/esm/onResponse.js

@@ -0,0 +1,26 @@
+// 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 { MethodNotFoundRpcError } from 'viem';
+// REF: https://github.com/wevm/viem/blob/main/src/clients/transports/fallback.ts#L17
+export function onResponse({ method, params = [], response, error, transport, }) {
+    if (error !== undefined) {
+        // @ts-expect-error Check if `cause.code` exists
+        const code = error?.code;
+        // noop on `MethodNotFoundRpcError`
+        if (code === MethodNotFoundRpcError.code)
+            return;
+        // Re-throw on `circle_` methods
+        if (method.startsWith('circle_') && code !== undefined)
+            throw error;
+    }
+    console.debug({ transport: transport.config.key, method, params, response });
+}
+//# sourceMappingURL=onResponse.js.map

package/dist/esm/onResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onResponse.js","sourceRoot":"","sources":["../../src/onResponse.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,sBAAsB,EAAE,MAAM,MAAM,CAAA;AAI7C,qFAAqF;AACrF,MAAM,UAAU,UAAU,CAAC,EACzB,MAAM,EACN,MAAM,GAAG,EAAE,EACX,QAAQ,EACR,KAAK,EACL,SAAS,GAOV;IACC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,gDAAgD;QAChD,MAAM,IAAI,GAAG,KAAK,EAAE,IAA0B,CAAA;QAE9C,mCAAmC;QACnC,IAAI,IAAI,KAAK,sBAAsB,CAAC,IAAI;YAAE,OAAM;QAEhD,gCAAgC;QAChC,IAAI,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM,KAAK,CAAA;IACrE,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAA;AAC9E,CAAC"}

package/dist/esm/onResponse.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=onResponse.test.d.ts.map

package/dist/esm/onResponse.test.d.ts.map

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

package/dist/esm/onResponse.test.js

@@ -0,0 +1,41 @@
+// 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 { describe, test, expect } from 'vitest';
+import { ErrorWithCause } from './errors/ErrorWithCause.js';
+import { MethodNotFoundRpcError } from './errors/index.js';
+import { onResponse } from './onResponse.js';
+describe.concurrent('onResponse', () => {
+    const transport = {
+        config: {
+            type: 'custom',
+        },
+    };
+    test.each([
+        ['eth_ebc', undefined],
+        ['circle_abc', undefined],
+        ['eth_ebc', new Error('hello')],
+        ['circle_abc', new Error('hello')],
+        ['eth_ebc', new ErrorWithCause('MethodNotFoundRpcError', { cause: { code: -32601 } })],
+        ['circle_abc', new ErrorWithCause('MethodNotFoundRpcError', { cause: { code: -32601 } })],
+        ['circle_abc', new MethodNotFoundRpcError(undefined, { method: 'circle_abc' })],
+    ])('should noop', (method, error) => {
+        expect(onResponse({ method, error, transport })).toEqual(undefined);
+    });
+    test.each([
+        ['circle_abc', new ErrorWithCause('E1', { cause: { code: -12345 } })],
+        ['circle_xyz', new ErrorWithCause('E2', { cause: { code: 0 } })],
+    ])('should raise error', (method, error) => {
+        expect(() => {
+            onResponse({ method, error, transport });
+        }).toThrowError(ErrorWithCause);
+    });
+});
+//# sourceMappingURL=onResponse.test.js.map

package/dist/esm/onResponse.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onResponse.test.js","sourceRoot":"","sources":["../../src/onResponse.test.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,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAI5C,QAAQ,CAAC,UAAU,CAAC,YAAY,EAAE,GAAG,EAAE;IACrC,MAAM,SAAS,GAAG;QAChB,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;SACf;KACuB,CAAA;IAE1B,IAAI,CAAC,IAAI,CAAC;QACR,CAAC,SAAS,EAAE,SAAS,CAAC;QACtB,CAAC,YAAY,EAAE,SAAS,CAAC;QACzB,CAAC,SAAS,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC,YAAY,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC,SAAS,EAAE,IAAI,cAAc,CAAC,wBAAwB,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACtF,CAAC,YAAY,EAAE,IAAI,cAAc,CAAC,wBAAwB,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACzF,CAAC,YAAY,EAAE,IAAI,sBAAsB,CAAC,SAA6B,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;KACpG,CAAC,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QAClC,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IACrE,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,IAAI,CAAC;QACR,CAAC,YAAY,EAAE,IAAI,cAAc,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACrE,CAAC,YAAY,EAAE,IAAI,cAAc,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;KACjE,CAAC,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QACzC,MAAM,CAAC,GAAG,EAAE;YACV,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAA;QAC1C,CAAC,CAAC,CAAC,YAAY,CAAC,cAAc,CAAC,CAAA;IACjC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/esm/providers/cross-chain-transfer-protocol/actions/index.d.ts

@@ -0,0 +1,11 @@
+import { listMessages } from './listMessages.js';
+import { waitForAttestationMessage } from './waitForAttestationMessage.js';
+import type { Transport, Chain, Client, Account } from 'viem';
+export * from './listMessages.js';
+export * from './waitForAttestationMessage.js';
+export type Actions = {
+    waitForAttestationMessage: (params: Parameters<typeof waitForAttestationMessage>[1]) => ReturnType<typeof waitForAttestationMessage>;
+    listMessages: (params: Parameters<typeof listMessages>[1]) => ReturnType<typeof listMessages>;
+};
+export declare function actions<transport extends Transport = Transport, chain extends Chain | undefined = Chain | undefined, account extends Account | undefined = Account | undefined>(client: Client<transport, chain, account>): Actions;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/providers/cross-chain-transfer-protocol/actions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/providers/cross-chain-transfer-protocol/actions/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAA;AAG1E,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAE7D,cAAc,mBAAmB,CAAA;AACjC,cAAc,gCAAgC,CAAA;AAE9C,MAAM,MAAM,OAAO,GAAG;IACpB,yBAAyB,EAAE,CACzB,MAAM,EAAE,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC,CAAC,CAAC,KACpD,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAA;IACjD,YAAY,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,OAAO,YAAY,CAAC,CAAA;CAC9F,CAAA;AAED,wBAAgB,OAAO,CACrB,SAAS,SAAS,SAAS,GAAG,SAAS,EACvC,KAAK,SAAS,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,EACnD,OAAO,SAAS,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,EACzD,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,OAAO,CAOpD"}

package/dist/esm/providers/cross-chain-transfer-protocol/actions/index.js

@@ -0,0 +1,22 @@
+// 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 { listMessages } from './listMessages.js';
+import { waitForAttestationMessage } from './waitForAttestationMessage.js';
+export * from './listMessages.js';
+export * from './waitForAttestationMessage.js';
+export function actions(client) {
+    const _client = client;
+    return {
+        waitForAttestationMessage: (params) => waitForAttestationMessage(_client, params),
+        listMessages: (params) => listMessages(_client, params),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/providers/cross-chain-transfer-protocol/actions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/providers/cross-chain-transfer-protocol/actions/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,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAA;AAK1E,cAAc,mBAAmB,CAAA;AACjC,cAAc,gCAAgC,CAAA;AAS9C,MAAM,UAAU,OAAO,CAIrB,MAAyC;IACzC,MAAM,OAAO,GAAG,MAA4B,CAAA;IAE5C,OAAO;QACL,yBAAyB,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,yBAAyB,CAAC,OAAO,EAAE,MAAM,CAAC;QACjF,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC;KACxD,CAAA;AACH,CAAC"}

package/dist/esm/providers/cross-chain-transfer-protocol/actions/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/esm/providers/cross-chain-transfer-protocol/actions/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../../../../src/providers/cross-chain-transfer-protocol/actions/index.test.ts"],"names":[],"mappings":""}

package/dist/esm/providers/cross-chain-transfer-protocol/actions/index.test.js

@@ -0,0 +1,31 @@
+// 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 { describe, expect, vi, afterEach, it } from 'vitest';
+import { ETH_SEPOLIA } from '../../../chains/index.js';
+import { actions } from './index.js';
+describe.concurrent('actions', () => {
+    const client = {
+        chain: ETH_SEPOLIA,
+    };
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('should return an object with the expected methods', () => {
+        const result = actions(client);
+        expect(result).toEqual({
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+            listMessages: expect.any(Function),
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+            waitForAttestationMessage: expect.any(Function),
+        });
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/esm/providers/cross-chain-transfer-protocol/actions/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../../../../src/providers/cross-chain-transfer-protocol/actions/index.test.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,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE5D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAEtD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAIpC,QAAQ,CAAC,UAAU,CAAC,SAAS,EAAE,GAAG,EAAE;IAClC,MAAM,MAAM,GAAG;QACb,KAAK,EAAE,WAAW;KACnB,CAAA;IAED,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,eAAe,EAAE,CAAA;IACtB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,MAAM,GAAG,OAAO,CAAC,MAA2B,CAAC,CAAA;QAEnD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,mEAAmE;YACnE,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClC,mEAAmE;YACnE,yBAAyB,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;SAChD,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/esm/providers/cross-chain-transfer-protocol/actions/listMessages.d.ts

@@ -0,0 +1,10 @@
+import type { ExtendedViemClient } from '../../../types.js';
+import type { ListMessagesParams, ListMessagesReturnType } from '../provider.js';
+/**
+ * Retrieves messages and attestations for a given transaction, supporting both V1 and V2 messages.
+ *
+ * @param client - The client instance to use for the operation.
+ * @returns Returns the messages for the given transaction
+ */
+export declare function listMessages(client: ExtendedViemClient, params: ListMessagesParams): Promise<ListMessagesReturnType>;
+//# sourceMappingURL=listMessages.d.ts.map

package/dist/esm/providers/cross-chain-transfer-protocol/actions/listMessages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listMessages.d.ts","sourceRoot":"","sources":["../../../../../src/providers/cross-chain-transfer-protocol/actions/listMessages.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AAEhF;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,sBAAsB,CAAC,CAEjC"}

package/dist/esm/providers/cross-chain-transfer-protocol/actions/listMessages.js

@@ -0,0 +1,20 @@
+// 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.
+/**
+ * Retrieves messages and attestations for a given transaction, supporting both V1 and V2 messages.
+ *
+ * @param client - The client instance to use for the operation.
+ * @returns Returns the messages for the given transaction
+ */
+export async function listMessages(client, params) {
+    return await client.request({ method: 'circle_listMessages', params: [params] });
+}
+//# sourceMappingURL=listMessages.js.map

package/dist/esm/providers/cross-chain-transfer-protocol/actions/listMessages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listMessages.js","sourceRoot":"","sources":["../../../../../src/providers/cross-chain-transfer-protocol/actions/listMessages.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,uBAAuB;AACvB,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,8EAA8E;AAC9E,yEAAyE;AACzE,mFAAmF;AAKnF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAA0B,EAC1B,MAA0B;IAE1B,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;AAClF,CAAC"}

package/dist/esm/providers/cross-chain-transfer-protocol/actions/listMessages.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=listMessages.test.d.ts.map

package/dist/esm/providers/cross-chain-transfer-protocol/actions/listMessages.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listMessages.test.d.ts","sourceRoot":"","sources":["../../../../../src/providers/cross-chain-transfer-protocol/actions/listMessages.test.ts"],"names":[],"mappings":""}

package/dist/esm/providers/cross-chain-transfer-protocol/actions/listMessages.test.js

@@ -0,0 +1,47 @@
+// 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 { describe, test, expect, vi, afterEach } from 'vitest';
+import { listMessages as action } from './listMessages.js';
+describe.concurrent(`${action.name}`, () => {
+    const client = {
+        request: vi.fn(),
+    };
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    test.each([
+        [
+            {
+                sourceDomainId: 0,
+                transactionHash: '0x0000000000000000000000000000000000000000',
+                isTestnet: false,
+            },
+            [
+                {
+                    message: '0x0000',
+                    nonce: '123123',
+                    attestation: '0x00000',
+                    cctpVersion: 123,
+                    status: 'complete',
+                },
+            ],
+        ],
+    ])('should list Messages', async (params, expectedResult) => {
+        client.request.mockResolvedValue(expectedResult);
+        const result = await action(client, params);
+        expect(result).toMatchObject(expectedResult);
+        expect(client.request).toHaveBeenCalledWith({
+            method: `circle_${action.name}`,
+            params: [params],
+        });
+    });
+});
+//# sourceMappingURL=listMessages.test.js.map

package/dist/esm/providers/cross-chain-transfer-protocol/actions/listMessages.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listMessages.test.js","sourceRoot":"","sources":["../../../../../src/providers/cross-chain-transfer-protocol/actions/listMessages.test.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,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAE9D,OAAO,EAAE,YAAY,IAAI,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAI1D,QAAQ,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE;IACzC,MAAM,MAAM,GAAG;QACb,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE;KACR,CAAA;IAEV,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,eAAe,EAAE,CAAA;IACtB,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,IAAI,CAAC;QACR;YACE;gBACE,cAAc,EAAE,CAAC;gBACjB,eAAe,EAAE,4CAA4C;gBAC7D,SAAS,EAAE,KAAK;aACjB;YACD;gBACE;oBACE,OAAO,EAAE,QAAQ;oBACjB,KAAK,EAAE,QAAQ;oBACf,WAAW,EAAE,SAAS;oBACtB,WAAW,EAAE,GAAG;oBAChB,MAAM,EAAE,UAAU;iBACnB;aACF;SACF;KACO,CAAC,CAAC,sBAAsB,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE;QACnE,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAA;QAEhD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAuC,EAAE,MAAM,CAAC,CAAA;QAE5E,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,cAAc,CAAC,CAAA;QAC5C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,oBAAoB,CAAC;YAC1C,MAAM,EAAE,UAAU,MAAM,CAAC,IAAI,EAAE;YAC/B,MAAM,EAAE,CAAC,MAAM,CAAC;SACjB,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/esm/providers/cross-chain-transfer-protocol/actions/waitForAttestationMessage.d.ts

@@ -0,0 +1,19 @@
+import type { ExtendedViemClient } from '../../../types.js';
+import type { Message } from '../provider.js';
+import type { Chain } from 'viem';
+export type WaitForAttestationMessageParams = {
+    hash: string;
+    chain?: Chain;
+};
+export type AttestedMessage = Omit<Message, 'attestation' | 'status'> & {
+    status: 'complete';
+    attestation: NonNullable<Message['attestation']>;
+};
+/**
+ * Waits for an attestation of a transaction hash for the Cross-Chain Transfer Protocol (CCTP).
+ *
+ * @param client - The client instance to use for the operation.
+ * @returns Returns the attestation of the transaction hash.
+ */
+export declare function waitForAttestationMessage(client: ExtendedViemClient, params: WaitForAttestationMessageParams): Promise<AttestedMessage>;
+//# sourceMappingURL=waitForAttestationMessage.d.ts.map

package/dist/esm/providers/cross-chain-transfer-protocol/actions/waitForAttestationMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waitForAttestationMessage.d.ts","sourceRoot":"","sources":["../../../../../src/providers/cross-chain-transfer-protocol/actions/waitForAttestationMessage.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,MAAM,CAAA;AAEjC,MAAM,MAAM,+BAA+B,GAAG;IAC5C,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,KAAK,CAAA;CACd,CAAA;AAED,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,QAAQ,CAAC,GAAG;IACtE,MAAM,EAAE,UAAU,CAAA;IAClB,WAAW,EAAE,WAAW,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAA;CACjD,CAAA;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,+BAA+B,GACtC,OAAO,CAAC,eAAe,CAAC,CAmB1B"}

package/dist/esm/providers/cross-chain-transfer-protocol/actions/waitForAttestationMessage.js

@@ -0,0 +1,37 @@
+// 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 { setTimeout } from 'node:timers/promises';
+import { getAction } from 'viem/utils';
+import { extractChain } from '../extractChain.js';
+import { listMessages as _listMessages } from './listMessages.js';
+/**
+ * Waits for an attestation of a transaction hash for the Cross-Chain Transfer Protocol (CCTP).
+ *
+ * @param client - The client instance to use for the operation.
+ * @returns Returns the attestation of the transaction hash.
+ */
+export async function waitForAttestationMessage(client, params) {
+    const listMessages = getAction(client, _listMessages, 'listMessages');
+    const { hash: transactionHash, chain: _chain = client.chain } = params;
+    const chain = extractChain(_chain);
+    const sourceDomainId = chain.domainId;
+    const isTestnet = chain.testnet;
+    while (true) {
+        const messages = await listMessages({ sourceDomainId, transactionHash, isTestnet });
+        const message = messages.at(0);
+        if (message?.status === 'complete' && typeof message?.attestation === 'string') {
+            return message;
+        }
+        // NOTE: Circle recommends 5s
+        await setTimeout(5000);
+    }
+}
+//# sourceMappingURL=waitForAttestationMessage.js.map

package/dist/esm/providers/cross-chain-transfer-protocol/actions/waitForAttestationMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"waitForAttestationMessage.js","sourceRoot":"","sources":["../../../../../src/providers/cross-chain-transfer-protocol/actions/waitForAttestationMessage.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,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEjD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAEtC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,YAAY,IAAI,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAgBjE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,MAA0B,EAC1B,MAAuC;IAEvC,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,cAAc,CAAC,CAAA;IAErE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,GAAG,MAAM,CAAA;IACtE,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,CAAA;IAClC,MAAM,cAAc,GAAG,KAAK,CAAC,QAAQ,CAAA;IACrC,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAA;IAE/B,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,EAAE,cAAc,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC,CAAA;QACnF,MAAM,OAAO,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QAE9B,IAAI,OAAO,EAAE,MAAM,KAAK,UAAU,IAAI,OAAO,OAAO,EAAE,WAAW,KAAK,QAAQ,EAAE,CAAC;YAC/E,OAAO,OAA0B,CAAA;QACnC,CAAC;QAED,6BAA6B;QAC7B,MAAM,UAAU,CAAC,IAAI,CAAC,CAAA;IACxB,CAAC;AACH,CAAC"}

package/dist/esm/providers/cross-chain-transfer-protocol/actions/waitForAttestationMessage.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=waitForAttestationMessage.test.d.ts.map

package/dist/esm/providers/cross-chain-transfer-protocol/actions/waitForAttestationMessage.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waitForAttestationMessage.test.d.ts","sourceRoot":"","sources":["../../../../../src/providers/cross-chain-transfer-protocol/actions/waitForAttestationMessage.test.ts"],"names":[],"mappings":""}