@circle-fin/provider-cctp-v2 1.8.0 → 1.8.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @circle-fin/provider-cctp-v2
 
+## 1.8.2
+
+### Patch Changes
+
+- Internal dependency updates. No user-facing changes.
+
+## 1.8.1
+
+### Patch Changes
+
+- Internal dependency updates. No user-facing changes.
+
 ## 1.8.0
 
 ### Minor Changes

package/index.cjs

@@ -400,23 +400,21 @@ var UnifiedBalanceChain;
  * Enumeration of blockchains that support earn (vault deposit/withdraw)
  * operations through the Earn Kit.
  *
- * Currently only Ethereum mainnet is supported. Additional chains
- * will be added as vault protocol support expands.
- *
  * @example
  * ```typescript
  * import { EarnChain } from '@core/chains'
  *
  * const result = await earnKit.deposit({
- *   from: { adapter, chain: EarnChain.Ethereum },
+ *   from: { adapter, chain: EarnChain.Arc_Testnet },
  *   vaultAddress: '0x...',
  *   amount: '100',
  * })
  * ```
  */
+// Values must match Blockchain enum members exactly.
 var EarnChain;
 (function (EarnChain) {
-    EarnChain["Ethereum"] = "Ethereum";
+    EarnChain["Arc_Testnet"] = "Arc_Testnet";
 })(EarnChain || (EarnChain = {}));
 
 /**
@@ -4094,7 +4092,7 @@ zod.z.union([
  * Zod schema for validating earn-specific chain identifiers.
  *
  * Validate that the provided chain is supported for earn (vault
- * deposit/withdraw) operations. Currently only Ethereum is
+ * deposit/withdraw) operations. Currently only Arc Testnet is
  * supported.
  *
  * Accept an EarnChain enum value, a matching string literal, or
@@ -4103,12 +4101,12 @@ zod.z.union([
  * @example
  * ```typescript
  * import { earnChainIdentifierSchema } from '@core/chains'
- * import { EarnChain, Ethereum } from '@core/chains'
+ * import { ArcTestnet, EarnChain } from '@core/chains'
  *
  * // Valid
- * earnChainIdentifierSchema.parse(EarnChain.Ethereum)
- * earnChainIdentifierSchema.parse('Ethereum')
- * earnChainIdentifierSchema.parse(Ethereum)
+ * earnChainIdentifierSchema.parse(EarnChain.Arc_Testnet)
+ * earnChainIdentifierSchema.parse('Arc_Testnet')
+ * earnChainIdentifierSchema.parse(ArcTestnet)
  *
  * // Invalid (throws ZodError)
  * earnChainIdentifierSchema.parse('Solana')
@@ -12248,7 +12246,7 @@ async function buildBatchedStep(name, receipt, batchId, adapter, chain, statusCo
     return step;
 }
 
-var version = "1.8.0";
+var version = "1.8.2";
 var pkg = {
 	version: version};
 
@@ -12662,7 +12660,9 @@ const hexStringSchema = zod.z
  * console.log(result.success) // true
  * ```
  */
-hexStringSchema.refine((value) => value.length === 42, 'EVM address must be exactly 42 characters long (0x + 40 hex characters)');
+hexStringSchema
+    .refine((value) => value.length === 42, 'EVM address must be exactly 42 characters long (0x + 40 hex characters)')
+    .transform((value) => value);
 /**
  * Schema for validating transaction hashes.
  *
@@ -12683,6 +12683,29 @@ hexStringSchema.refine((value) => value.length === 42, 'EVM address must be exac
  * ```
  */
 hexStringSchema.refine((value) => value.length === 66, 'Transaction hash must be exactly 66 characters long (0x + 64 hex characters)');
+/**
+ * Schema for validating EVM signatures.
+ *
+ * This schema validates that a string is a properly formatted 65-byte EVM
+ * signature:
+ * - Must be a valid hex string with '0x' prefix
+ * - Must be exactly 132 characters long (0x + 130 hex characters)
+ *
+ * @throws {KitError} If validation fails with INPUT_VALIDATION_FAILED code (1098), with details about which properties failed
+ *
+ * @example
+ * ```typescript
+ * import { evmSignatureSchema } from '@core/adapter'
+ *
+ * const validSignature = `0x${'ab'.repeat(65)}`
+ *
+ * const result = evmSignatureSchema.safeParse(validSignature)
+ * console.log(result.success) // true
+ * ```
+ */
+hexStringSchema
+    .refine((value) => value.length === 132, 'EVM signature must be exactly 132 characters long (0x + 130 hex characters)')
+    .transform((value) => value);
 /**
  * Schema for validating base58-encoded strings.
  *

package/index.d.ts

@@ -1810,12 +1810,14 @@ declare enum PermitType {
  * The Adapter Contract uses this to pull tokens from the user's wallet
  * using permit signatures instead of requiring separate approval transactions.
  *
+ * Shared by the `swap.*` and `earn.*` action namespaces because both forward
+ * `tokenInputs` unchanged to the adapter contract's `execute` call.
+ *
  * @example
  * ```typescript
  * const tokenInput: TokenInput = {
  *   permitType: PermitType.EIP2612,
  *   token: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', // USDC
- *   from: '0x742d35Cc6634C0532925a3b844Bc454e4438f44e',
  *   amount: 1000000n, // 1 USDC
  *   permitCalldata: '0x...' // Encoded permit(value, deadline, v, r, s)
  * }
@@ -1838,12 +1840,91 @@ interface TokenInput {
      * ABI-encoded permit calldata.
      *
      * For EIP-2612: encode(value, deadline, v, r, s)
-     * For Permit2: encode(permit, signature)
      *
      * @example '0x0000000000000000000000000000000000000000000000000000000000989680...'
      */
     permitCalldata: `0x${string}`;
 }
+
+/**
+ * Parameters for executing a service-signed earn operation via the Adapter
+ * smart contract on EVM chains.
+ *
+ * Shared across earn action keys: `earn.deposit`, `earn.withdraw`, and
+ * `earn.claimRewards`. Each operation forwards the same `executeParams`,
+ * `tokenInputs`, and `signature` triple to the adapter contract's `execute`
+ * function. The service signs `executeParams` off-chain; the contract verifies
+ * the signature on-chain.
+ *
+ * @example
+ * ```typescript
+ * import type { ActionPayload } from '@core/adapter'
+ *
+ * const params: ActionPayload<'earn.deposit'> = {
+ *   executeParams: { instructions: [], tokens: [], execId: 1n, deadline: 0n, metadata: '0x' },
+ *   tokenInputs: [],
+ *   signature: '0x...',
+ * }
+ *
+ * const prepared = await adapter.prepareAction('earn.deposit', params, { chain, address })
+ * const txHash = await prepared.execute()
+ * ```
+ */
+interface ExecuteEarnEVMParams extends ActionParameters {
+    /**
+     * Execution parameters returned by the earn service.
+     *
+     * Kept as an opaque record so the adapter forwards the service-signed struct
+     * unchanged. The adapter contract ABI decodes it on-chain.
+     */
+    executeParams: Record<string, unknown>;
+    /**
+     * Token inputs with permit signatures for gasless approvals.
+     *
+     * Populated by the earn provider after it decides how token spending is
+     * authorised. Today deposit uses a separate `token.approve` transaction and
+     * passes `PermitType.NONE`; a future permit-enabled path can populate this
+     * field without a breaking change.
+     */
+    tokenInputs: TokenInput[];
+    /**
+     * EIP-712 signature from the earn service proxy.
+     *
+     * The adapter contract verifies this signature on-chain. Passed through
+     * unchanged.
+     */
+    signature: `0x${string}`;
+}
+/**
+ * Parameters for earn execute actions across supported ecosystems.
+ *
+ * EVM-only today; becomes a union when a non-EVM adapter implementation
+ * lands. Action handlers narrow via a property-based type guard, same
+ * pattern as {@link ExecuteSwapParams}.
+ */
+type ExecuteEarnParams = ExecuteEarnEVMParams;
+/**
+ * Action map for earn operations.
+ *
+ * Each action key forwards the same `(executeParams, tokenInputs, signature)`
+ * triple to the adapter contract. Provider-side orchestration performs any
+ * required token approval; this action only prepares the adapter execute call.
+ */
+interface EarnActionMap {
+    /**
+     * Execute a service-signed deposit against the adapter contract.
+     */
+    readonly deposit: ExecuteEarnParams;
+    /**
+     * Execute a service-signed withdraw against the adapter contract.
+     */
+    readonly withdraw: ExecuteEarnParams;
+    /**
+     * Execute a service-signed claim rewards against the adapter contract.
+     */
+    readonly claimRewards: ExecuteEarnParams;
+}
+
 /**
  * Single instruction to execute within the Adapter Contract.
  *
@@ -2025,7 +2106,6 @@ interface ExecuteParams {
  * const tokenInputs: TokenInput[] = [{
  *   permitType: PermitType.EIP2612,
  *   token: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
- *   from: userAddress,
  *   amount: 1000000n,
  *   permitCalldata: '0x...' // Encoded permit signature
  * }]
@@ -2068,7 +2148,6 @@ interface ExecuteSwapEVMParams extends ActionParameters {
      * [{
      *   permitType: PermitType.EIP2612,
      *   token: '0xUSDC',
-     *   from: userAddress,
      *   amount: 1000000n,
      *   permitCalldata: '0x...'
      * }]
@@ -2804,6 +2883,8 @@ interface ActionMap {
     readonly usdt: USDTActionMap;
     /** Swap operations for DEX aggregator integrations. */
     readonly swap: SwapActionMap;
+    /** Earn operations that execute service-signed payloads via the adapter contract. */
+    readonly earn: EarnActionMap;
 }
 /**
  * Determine if a type represents an action parameter object (leaf node).

package/index.mjs

@@ -393,23 +393,21 @@ var UnifiedBalanceChain;
  * Enumeration of blockchains that support earn (vault deposit/withdraw)
  * operations through the Earn Kit.
  *
- * Currently only Ethereum mainnet is supported. Additional chains
- * will be added as vault protocol support expands.
- *
  * @example
  * ```typescript
  * import { EarnChain } from '@core/chains'
  *
  * const result = await earnKit.deposit({
- *   from: { adapter, chain: EarnChain.Ethereum },
+ *   from: { adapter, chain: EarnChain.Arc_Testnet },
  *   vaultAddress: '0x...',
  *   amount: '100',
  * })
  * ```
  */
+// Values must match Blockchain enum members exactly.
 var EarnChain;
 (function (EarnChain) {
-    EarnChain["Ethereum"] = "Ethereum";
+    EarnChain["Arc_Testnet"] = "Arc_Testnet";
 })(EarnChain || (EarnChain = {}));
 
 /**
@@ -4087,7 +4085,7 @@ z.union([
  * Zod schema for validating earn-specific chain identifiers.
  *
  * Validate that the provided chain is supported for earn (vault
- * deposit/withdraw) operations. Currently only Ethereum is
+ * deposit/withdraw) operations. Currently only Arc Testnet is
  * supported.
  *
  * Accept an EarnChain enum value, a matching string literal, or
@@ -4096,12 +4094,12 @@ z.union([
  * @example
  * ```typescript
  * import { earnChainIdentifierSchema } from '@core/chains'
- * import { EarnChain, Ethereum } from '@core/chains'
+ * import { ArcTestnet, EarnChain } from '@core/chains'
  *
  * // Valid
- * earnChainIdentifierSchema.parse(EarnChain.Ethereum)
- * earnChainIdentifierSchema.parse('Ethereum')
- * earnChainIdentifierSchema.parse(Ethereum)
+ * earnChainIdentifierSchema.parse(EarnChain.Arc_Testnet)
+ * earnChainIdentifierSchema.parse('Arc_Testnet')
+ * earnChainIdentifierSchema.parse(ArcTestnet)
  *
  * // Invalid (throws ZodError)
  * earnChainIdentifierSchema.parse('Solana')
@@ -12241,7 +12239,7 @@ async function buildBatchedStep(name, receipt, batchId, adapter, chain, statusCo
     return step;
 }
 
-var version = "1.8.0";
+var version = "1.8.2";
 var pkg = {
 	version: version};
 
@@ -12655,7 +12653,9 @@ const hexStringSchema = z
  * console.log(result.success) // true
  * ```
  */
-hexStringSchema.refine((value) => value.length === 42, 'EVM address must be exactly 42 characters long (0x + 40 hex characters)');
+hexStringSchema
+    .refine((value) => value.length === 42, 'EVM address must be exactly 42 characters long (0x + 40 hex characters)')
+    .transform((value) => value);
 /**
  * Schema for validating transaction hashes.
  *
@@ -12676,6 +12676,29 @@ hexStringSchema.refine((value) => value.length === 42, 'EVM address must be exac
  * ```
  */
 hexStringSchema.refine((value) => value.length === 66, 'Transaction hash must be exactly 66 characters long (0x + 64 hex characters)');
+/**
+ * Schema for validating EVM signatures.
+ *
+ * This schema validates that a string is a properly formatted 65-byte EVM
+ * signature:
+ * - Must be a valid hex string with '0x' prefix
+ * - Must be exactly 132 characters long (0x + 130 hex characters)
+ *
+ * @throws {KitError} If validation fails with INPUT_VALIDATION_FAILED code (1098), with details about which properties failed
+ *
+ * @example
+ * ```typescript
+ * import { evmSignatureSchema } from '@core/adapter'
+ *
+ * const validSignature = `0x${'ab'.repeat(65)}`
+ *
+ * const result = evmSignatureSchema.safeParse(validSignature)
+ * console.log(result.success) // true
+ * ```
+ */
+hexStringSchema
+    .refine((value) => value.length === 132, 'EVM signature must be exactly 132 characters long (0x + 130 hex characters)')
+    .transform((value) => value);
 /**
  * Schema for validating base58-encoded strings.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@circle-fin/provider-cctp-v2",
-  "version": "1.8.0",
+  "version": "1.8.2",
   "description": "Circle's official Cross-Chain Transfer Protocol v2 provider for native USDC bridging",
   "keywords": [
     "circle",