@tatumio/wallet-sdk 0.0.2 → 0.2.0

package/dist/sdk.js.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAI1D;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,eAAe;IAOG;IAN7B,wGAAwG;IAC/F,GAAG,CAAmB;IAC/B,kGAAkG;IACzF,SAAS,CAAe;IAChB,cAAc,CAAsB;IAErD,YAA6B,MAAwB;QAAxB,WAAM,GAAN,MAAM,CAAkB;QACnD,IAAI,CAAC,GAAG,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,cAAc,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAChE,IAAI,CAAC,SAAS,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IACjE,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,MAAwB;QACjC,OAAO,IAAI,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACrE,CAAC;CACF"}
+{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAI1D;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,eAAe;IAOG;IAN7B,wGAAwG;IAC/F,GAAG,CAAmB;IAC/B,kGAAkG;IACzF,SAAS,CAAe;IAChB,cAAc,CAAsB;IAErD,YAA6B,MAAwB;QAAxB,WAAM,GAAN,MAAM,CAAkB;QACnD,IAAI,CAAC,GAAG,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,cAAc,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAChE,IAAI,CAAC,SAAS,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,MAAwB;QACjC,OAAO,IAAI,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACrE,CAAC;CACF"}

package/dist/tatum/provider.d.ts

@@ -3,10 +3,19 @@ import type { WalletsSDKConfig } from '../types.js';
 export declare class PortalTatumProvider {
     private readonly tatumClient;
     private readonly config;
-    private custodianTokenPromise;
     constructor(tatumClient: WalletsApiClient, config: WalletsSDKConfig);
-    getCustodianToken(): Promise<string>;
-    private fetchCustodianToken;
+    /**
+     * Report a wallet generation to Tatum's usage meter. Best-effort: authenticated
+     * with the client's Portal token (bearer) on top of the SDK's `x-api-key`, and
+     * any failure is swallowed so metering never breaks the underlying operation.
+     */
+    trackWalletCreation(clientToken: string): Promise<void>;
+    /**
+     * Report a signing operation (sign/rawSign/sendAssets) to Tatum's usage meter.
+     * Best-effort — see {@link trackWalletCreation}.
+     */
+    trackTransaction(clientToken: string): Promise<void>;
+    private meterUsage;
     /**
      * Resolve the Tatum RPC gateway URL for a supported chain, in the form
      * `https://<network>.gateway.tatum.io/<apiKey>`. `chain` is the Portal

package/dist/tatum/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/tatum/provider.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAOpD,qBAAa,mBAAmB;IAI5B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,OAAO,CAAC,qBAAqB,CAA8B;gBAGxC,WAAW,EAAE,gBAAgB,EAC7B,MAAM,EAAE,gBAAgB;IAG3C,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;YAWtB,mBAAmB;IAajC;;;;OAIG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAShD"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/tatum/provider.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,WAAW,EAAE,gBAAgB,EAC7B,MAAM,EAAE,gBAAgB;IAG3C;;;;OAIG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD;;;OAGG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAItC,UAAU;IAQxB;;;;OAIG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAShD"}

package/dist/tatum/provider.js

@@ -1,29 +1,34 @@
 import { WALLET_CHAINS } from '../chains.js';
-import { CUSTODIAN_API_KEY_PATH, TATUM_RPC_GATEWAY_DOMAIN } from '../constants/index.js';
+import { TATUM_RPC_GATEWAY_DOMAIN, USAGE_TRANSACTION_PATH, USAGE_WALLET_PATH } from '../constants/index.js';
 export class PortalTatumProvider {
     tatumClient;
     config;
-    custodianTokenPromise;
     constructor(tatumClient, config) {
         this.tatumClient = tatumClient;
         this.config = config;
     }
-    getCustodianToken() {
-        // The custodian key is stable for the SDK's lifetime, so resolve it once.
-        // Reset on failure so a transient error doesn't permanently poison the SDK.
-        this.custodianTokenPromise ??= this.fetchCustodianToken().catch((error) => {
-            this.custodianTokenPromise = undefined;
-            throw error;
-        });
-        return this.custodianTokenPromise;
+    /**
+     * Report a wallet generation to Tatum's usage meter. Best-effort: authenticated
+     * with the client's Portal token (bearer) on top of the SDK's `x-api-key`, and
+     * any failure is swallowed so metering never breaks the underlying operation.
+     */
+    trackWalletCreation(clientToken) {
+        return this.meterUsage(USAGE_WALLET_PATH, clientToken);
+    }
+    /**
+     * Report a signing operation (sign/rawSign/sendAssets) to Tatum's usage meter.
+     * Best-effort — see {@link trackWalletCreation}.
+     */
+    trackTransaction(clientToken) {
+        return this.meterUsage(USAGE_TRANSACTION_PATH, clientToken);
     }
-    async fetchCustodianToken() {
-        const response = await this.tatumClient.get(CUSTODIAN_API_KEY_PATH);
-        const token = response?.portalCustodianApiKey;
-        if (!token) {
-            throw new Error(`Tatum API key is not authorized for Portal: ${CUSTODIAN_API_KEY_PATH} returned no portalCustodianApiKey`);
+    async meterUsage(path, clientToken) {
+        try {
+            await this.tatumClient.post(path, {}, { headers: { authorization: `Bearer ${clientToken}` } });
+        }
+        catch {
+            // Best-effort metering: a metering failure must never surface to the caller.
         }
-        return token;
     }
     /**
      * Resolve the Tatum RPC gateway URL for a supported chain, in the form
@@ -31,7 +36,7 @@ export class PortalTatumProvider {
      * CAIP-2 id (the {@link WalletChain} value). Throws for unsupported chains.
      */
     async getRpcUrl(chain) {
-        const network = WALLET_CHAINS[chain]?.tatumRpcNetwork;
+        const network = WALLET_CHAINS[chain]?.tatumNetwork;
         if (!network) {
             throw new Error(`No Tatum RPC gateway configured for chain "${chain}"`);
         }

package/dist/tatum/provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/tatum/provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAUzF,MAAM,OAAO,mBAAmB;IAIX;IACA;IAJX,qBAAqB,CAA8B;IAE3D,YACmB,WAA6B,EAC7B,MAAwB;QADxB,gBAAW,GAAX,WAAW,CAAkB;QAC7B,WAAM,GAAN,MAAM,CAAkB;IACxC,CAAC;IAEJ,iBAAiB;QACf,0EAA0E;QAC1E,4EAA4E;QAC5E,IAAI,CAAC,qBAAqB,KAAK,IAAI,CAAC,mBAAmB,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACjF,IAAI,CAAC,qBAAqB,GAAG,SAAS,CAAC;YACvC,MAAM,KAAK,CAAC;QACd,CAAC,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,qBAAqB,CAAC;IACpC,CAAC;IAEO,KAAK,CAAC,mBAAmB;QAC/B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAA0B,sBAAsB,CAAC,CAAC;QAC7F,MAAM,KAAK,GAAG,QAAQ,EAAE,qBAAqB,CAAC;QAE9C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,+CAA+C,sBAAsB,oCAAoC,CAC1G,CAAC;QACJ,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,SAAS,CAAC,KAAa;QAC3B,MAAM,OAAO,GAAG,aAAa,CAAC,KAAoB,CAAC,EAAE,eAAe,CAAC;QAErE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,8CAA8C,KAAK,GAAG,CAAC,CAAC;QAC1E,CAAC;QAED,OAAO,WAAW,OAAO,IAAI,wBAAwB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IAChF,CAAC;CACF"}
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/tatum/provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,uBAAuB,CAAC;AAK/B,MAAM,OAAO,mBAAmB;IAEX;IACA;IAFnB,YACmB,WAA6B,EAC7B,MAAwB;QADxB,gBAAW,GAAX,WAAW,CAAkB;QAC7B,WAAM,GAAN,MAAM,CAAkB;IACxC,CAAC;IAEJ;;;;OAIG;IACH,mBAAmB,CAAC,WAAmB;QACrC,OAAO,IAAI,CAAC,UAAU,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC;IACzD,CAAC;IAED;;;OAGG;IACH,gBAAgB,CAAC,WAAmB;QAClC,OAAO,IAAI,CAAC,UAAU,CAAC,sBAAsB,EAAE,WAAW,CAAC,CAAC;IAC9D,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,WAAmB;QACxD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;QACjG,CAAC;QAAC,MAAM,CAAC;YACP,6EAA6E;QAC/E,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,SAAS,CAAC,KAAa;QAC3B,MAAM,OAAO,GAAG,aAAa,CAAC,KAAoB,CAAC,EAAE,YAAY,CAAC;QAElE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,8CAA8C,KAAK,GAAG,CAAC,CAAC;QAC1E,CAAC;QAED,OAAO,WAAW,OAAO,IAAI,wBAAwB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IAChF,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tatumio/wallet-sdk",
-  "version": "0.0.2",
+  "version": "0.2.0",
   "description": "TypeScript SDK for Tatum-hosted MPC wallets — wallet generation, signing, sending, backup/recovery, and custodian/client management.",
   "license": "MIT",
   "author": "Tatum",
@@ -57,5 +57,9 @@
     "@types/node": "^22.15.29",
     "typescript": "^5.8.3",
     "vitest": "^3.1.4"
+  },
+  "dependencies": {
+    "@noble/curves": "^1.9.7",
+    "@scure/base": "^1.2.6"
   }
 }