@4mica/sdk 1.2.14 → 1.2.17

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@4mica/sdk",
-    "version": "1.2.14",
+    "version": "1.2.16",
     "description": "TypeScript SDK for interacting with the 4Mica payment network",
     "license": "MIT",
     "repository": {

package/dist/src/client/user.d.ts

@@ -59,13 +59,13 @@ export declare class UserClient {
     /**
      * List all tabs where the current signer is the payer.
      *
-     * @param recipientAddress - Address of the recipient to query tabs from.
+     * @param settlementStatuses - Optional filter on settlement status (e.g. `['pending']`).
      * @returns Array of tabs belonging to the current signer.
      */
-    listTabs(recipientAddress: string): Promise<TabInfo[]>;
+    listTabs(settlementStatuses?: string[]): Promise<TabInfo[]>;
     /**
-     * Pay a tab on-chain. Automatically resolves the recipient, asset, and amount
-     * from the tab and its latest guarantee.
+     * Pay the remaining tab balance on-chain. Automatically resolves the recipient,
+     * asset, and remaining amount from the tab and its latest guarantee.
      *
      * @param tabId - Tab identifier.
      * @param waitOptions - Optional timeout/polling overrides.

package/dist/src/client/user.js

@@ -81,15 +81,13 @@ class UserClient {
     /**
      * List all tabs where the current signer is the payer.
      *
-     * @param recipientAddress - Address of the recipient to query tabs from.
+     * @param settlementStatuses - Optional filter on settlement status (e.g. `['pending']`).
      * @returns Array of tabs belonging to the current signer.
      */
-    async listTabs(recipientAddress) {
+    async listTabs(settlementStatuses) {
         const myAddress = (0, utils_1.normalizeAddress)(this.client.signer.signer.address);
-        const raw = await this.client.rpc.listRecipientTabs(recipientAddress);
-        return raw
-            .map((t) => models_1.TabInfo.fromRpc(t))
-            .filter((t) => (0, utils_1.normalizeAddress)(t.userAddress) === myAddress);
+        const raw = await this.client.rpc.listUserTabs(myAddress, settlementStatuses);
+        return raw.map((t) => models_1.TabInfo.fromRpc(t));
     }
     async payTab(tabId, reqIdOrWaitOptions, amount, recipientAddress, erc20Token, waitOptions) {
         // Simple overload: auto-resolve from tab + latest guarantee
@@ -104,10 +102,14 @@ class UserClient {
             const guarantee = await this.client.recipient.getLatestGuarantee(tabId);
             if (!guarantee)
                 throw new Error(`Tab ${tabId} has no guarantee`);
+            const remaining = tab.totalAmount > tab.paidAmount ? tab.totalAmount - tab.paidAmount : 0n;
+            if (remaining === 0n) {
+                throw new Error(`Tab ${tabId} is already fully paid`);
+            }
             const isEth = tab.assetAddress === '0x0000000000000000000000000000000000000000';
             return isEth
-                ? this.client.gateway.payTabEth(tabId, guarantee.reqId, guarantee.amount, tab.recipientAddress, opts)
-                : this.client.gateway.payTabErc20(tabId, guarantee.amount, tab.assetAddress, tab.recipientAddress, opts);
+                ? this.client.gateway.payTabEth(tabId, guarantee.reqId, remaining, tab.recipientAddress, opts)
+                : this.client.gateway.payTabErc20(tabId, remaining, tab.assetAddress, tab.recipientAddress, opts);
         }
         // Explicit overload
         const reqId = reqIdOrWaitOptions;

package/dist/src/models.d.ts

@@ -172,7 +172,9 @@ export declare class TabInfo {
     settlementStatus: string;
     createdAt: number;
     updatedAt: number;
-    constructor(tabId: bigint, userAddress: string, recipientAddress: string, assetAddress: string, startTimestamp: number, ttlSeconds: number, status: string, settlementStatus: string, createdAt: number, updatedAt: number);
+    totalAmount: bigint;
+    paidAmount: bigint;
+    constructor(tabId: bigint, userAddress: string, recipientAddress: string, assetAddress: string, startTimestamp: number, ttlSeconds: number, status: string, settlementStatus: string, createdAt: number, updatedAt: number, totalAmount?: bigint, paidAmount?: bigint);
     static fromRpc(raw: Record<string, unknown>): TabInfo;
 }
 export declare class GuaranteeInfo {

package/dist/src/models.js

@@ -153,7 +153,9 @@ class TabInfo {
     settlementStatus;
     createdAt;
     updatedAt;
-    constructor(tabId, userAddress, recipientAddress, assetAddress, startTimestamp, ttlSeconds, status, settlementStatus, createdAt, updatedAt) {
+    totalAmount;
+    paidAmount;
+    constructor(tabId, userAddress, recipientAddress, assetAddress, startTimestamp, ttlSeconds, status, settlementStatus, createdAt, updatedAt, totalAmount = 0n, paidAmount = 0n) {
         this.tabId = tabId;
         this.userAddress = userAddress;
         this.recipientAddress = recipientAddress;
@@ -164,9 +166,11 @@ class TabInfo {
         this.settlementStatus = settlementStatus;
         this.createdAt = createdAt;
         this.updatedAt = updatedAt;
+        this.totalAmount = totalAmount;
+        this.paidAmount = paidAmount;
     }
     static fromRpc(raw) {
-        return new TabInfo((0, utils_1.parseU256)(((0, serde_1.getAny)(raw, 'tab_id', 'tabId') ?? 0)), ((0, serde_1.getAny)(raw, 'user_address', 'userAddress') ?? ''), ((0, serde_1.getAny)(raw, 'recipient_address', 'recipientAddress') ?? ''), ((0, serde_1.getAny)(raw, 'asset_address', 'assetAddress') ?? ''), Number((0, serde_1.getAny)(raw, 'start_timestamp', 'startTimestamp')), Number((0, serde_1.getAny)(raw, 'ttl_seconds', 'ttlSeconds')), ((0, serde_1.getAny)(raw, 'status') ?? ''), ((0, serde_1.getAny)(raw, 'settlement_status', 'settlementStatus') ?? ''), Number((0, serde_1.getAny)(raw, 'created_at', 'createdAt')), Number((0, serde_1.getAny)(raw, 'updated_at', 'updatedAt')));
+        return new TabInfo((0, utils_1.parseU256)(((0, serde_1.getAny)(raw, 'tab_id', 'tabId') ?? 0)), ((0, serde_1.getAny)(raw, 'user_address', 'userAddress') ?? ''), ((0, serde_1.getAny)(raw, 'recipient_address', 'recipientAddress') ?? ''), ((0, serde_1.getAny)(raw, 'asset_address', 'assetAddress') ?? ''), Number((0, serde_1.getAny)(raw, 'start_timestamp', 'startTimestamp')), Number((0, serde_1.getAny)(raw, 'ttl_seconds', 'ttlSeconds')), ((0, serde_1.getAny)(raw, 'status') ?? ''), ((0, serde_1.getAny)(raw, 'settlement_status', 'settlementStatus') ?? ''), Number((0, serde_1.getAny)(raw, 'created_at', 'createdAt')), Number((0, serde_1.getAny)(raw, 'updated_at', 'updatedAt')), (0, utils_1.parseU256)(((0, serde_1.getAny)(raw, 'total_amount', 'totalAmount') ?? 0)), (0, utils_1.parseU256)(((0, serde_1.getAny)(raw, 'paid_amount', 'paidAmount') ?? 0)));
     }
 }
 exports.TabInfo = TabInfo;

package/dist/src/rpc.d.ts

@@ -24,6 +24,7 @@ export declare class RpcProxy {
     listPendingRemunerations(recipientAddress: string): Promise<Record<string, unknown>[]>;
     getTab(tabId: number | bigint): Promise<Record<string, unknown> | null>;
     listRecipientTabs(recipientAddress: string, settlementStatuses?: string[]): Promise<Record<string, unknown>[]>;
+    listUserTabs(userAddress: string, settlementStatuses?: string[]): Promise<Record<string, unknown>[]>;
     getTabGuarantees(tabId: number | bigint): Promise<Record<string, unknown>[]>;
     getLatestGuarantee(tabId: number | bigint): Promise<Record<string, unknown> | null>;
     getGuarantee(tabId: number | bigint, reqId: number | bigint): Promise<Record<string, unknown> | null>;

package/dist/src/rpc.js

@@ -113,6 +113,14 @@ class RpcProxy {
         }
         return this.get(`/core/recipients/${recipientAddress}/tabs${query}`);
     }
+    async listUserTabs(userAddress, settlementStatuses) {
+        let query = '';
+        if (settlementStatuses?.length) {
+            query =
+                '?' + settlementStatuses.map((s) => `settlement_status=${encodeURIComponent(s)}`).join('&');
+        }
+        return this.get(`/core/users/${userAddress}/tabs${query}`);
+    }
     async getTabGuarantees(tabId) {
         return this.get(`/core/tabs/${serializeTabId(tabId)}/guarantees`);
     }

package/dist/src/wallet/cdp.d.ts

@@ -4,6 +4,8 @@ export interface CdpAccountConfig {
     apiKeyId: string;
     /** CDP API key secret from the Coinbase Developer Platform dashboard. */
     apiKeySecret: string;
+    /** CDP wallet secret — required for account creation/signing operations. */
+    walletSecret: string;
     /** Idempotency name — getOrCreateAccount always returns the same wallet for a given name. */
     name: string;
 }

package/dist/src/wallet/cdp.js

@@ -42,6 +42,7 @@ async function createCdpAccount(config) {
     const cdp = new CdpClient({
         apiKeyId: config.apiKeyId,
         apiKeySecret: config.apiKeySecret,
+        walletSecret: config.walletSecret,
     });
     const evmAccount = await cdp.evm.getOrCreateAccount({ name: config.name });
     const address = evmAccount.address;
@@ -56,18 +57,10 @@ async function createCdpAccount(config) {
         return result.signature;
     }
     async function signTypedData(parameters) {
-        const { domain, types, primaryType, message } = parameters;
-        if (domain && types && primaryType && message) {
-            try {
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                const payload = { address, domain, types, primaryType, message };
-                const result = await cdp.evm.signTypedData(payload);
-                return result.signature;
-            }
-            catch {
-                // Fall back to hash-then-sign if CDP rejects the typed-data structure.
-            }
-        }
+        // Always hash locally with viem (guaranteed correct EIP-712 encoding including
+        // non-standard types like uint64) and sign only the hash via CDP.
+        // CDP's native signTypedData can silently produce a wrong hash for custom types,
+        // which would pass without error but fail signature verification on the core side.
         const hash = (0, viem_1.hashTypedData)(parameters);
         const result = await cdp.evm.signHash({ address, hash });
         return result.signature;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@4mica/sdk",
-  "version": "1.2.14",
+  "version": "1.2.17",
   "description": "TypeScript SDK for interacting with the 4Mica payment network",
   "license": "MIT",
   "repository": {