@springmint/x402-payment 1.0.1 → 1.0.2

package/README.md

@@ -148,9 +148,27 @@ npx @springmint/x402-payment \
 | `--input` | No | JSON request body |
 | `--method` | No | HTTP method (default: GET for direct, POST for entrypoint) |
 | `--check` | No | Verify wallet configuration and exit |
+| `--approve` | No | Approve token spending (requires `--token` and `--network`) |
+| `--allowance` | No | Check current token allowance (requires `--token` and `--network`) |
+| `--token` | No | Token contract address (used with `--approve` / `--allowance`) |
+| `--network` | No | Network identifier, e.g. `eip155:97`, `tron:nile` (used with `--approve` / `--allowance`) |
+| `--type` | No | Chain type: `evm` (default) or `tron` (used with `--approve` / `--allowance`) |
 
 Output goes to **stdout** as JSON. Logs go to **stderr**.
 
+**Token approval examples:**
+
+```bash
+# Check USDT allowance on BSC testnet
+npx @springmint/x402-payment --allowance --token 0x337610d27c682E347C9cD60BD4b3b107C9d34dDd --network eip155:97
+
+# Approve USDT on BSC testnet
+npx @springmint/x402-payment --approve --token 0x337610d27c682E347C9cD60BD4b3b107C9d34dDd --network eip155:97
+
+# Approve USDT on TRON nile
+npx @springmint/x402-payment --approve --token TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf --network tron:nile --type tron
+```
+
 ## API Reference
 
 ### `createX402FetchClient(options?)`
@@ -190,6 +208,23 @@ Search for a private key following the lookup order described in [Wallet Configu
 
 Search for TronGrid API key using the same lookup order.
 
+### `checkAllowance(type, token, network, options?)`
+
+Check current token allowance for the wallet.
+
+```ts
+const allowance = await checkAllowance("evm", "0x55d3...7955", "eip155:56");
+console.log(`Allowance: ${allowance}`);
+```
+
+### `approveToken(type, token, network, options?)`
+
+Approve unlimited token spending for x402 payments.
+
+```ts
+await approveToken("evm", "0x55d3...7955", "eip155:56");
+```
+
 ## Supported Networks & Tokens
 
 | Chain    | Network       | Tokens           | Example USDT Contract |
@@ -201,32 +236,104 @@ Search for TronGrid API key using the same lookup order.
 
 Both **direct transfer** and **permit-based** payment mechanisms are supported on all chains.
 
-## For AI Agent Skill Developers
+## Create Your Own Skill with x402 Payment
 
-If you're building a skill that calls a paid API, add this package as a dependency:
+If you have a paid API protected by x402, you can create a skill file so AI agents can call it automatically.
 
-```bash
-npm install @springmint/x402-payment
-```
+### Step 1: Create SKILL.md
 
-Then in your skill's code:
+Create a `SKILL.md` file for your API:
 
-```ts
+```markdown
+---
+name: my-api-skill
+description: "Description of your API and when to use it."
+version: 1.0.0
+dependencies:
+  - "@springmint/x402-payment"
+---
+
+# My API Skill
+
+> **Prerequisites**: Install and configure `@springmint/x402-payment`.
+> See [wallet configuration](https://github.com/springmint/x402-payment#wallet-configuration).
+>
+> ```bash
+> npm install @springmint/x402-payment
+> npx @springmint/x402-payment --check
+> ```
+
+## Endpoint
+
+\`\`\`
+POST https://your-api.com/api/your-endpoint
+Content-Type: application/json
+\`\`\`
+
+## Using with x402-payment
+
+### CLI (AI Agent)
+
+\`\`\`bash
+npx @springmint/x402-payment \
+  --url https://your-api.com/api/your-endpoint \
+  --method POST \
+  --input '{"key": "value"}'
+\`\`\`
+
+### Library (Node.js)
+
+\`\`\`ts
 import { createX402FetchClient } from "@springmint/x402-payment";
 
 const client = await createX402FetchClient();
-const res = await client.request("https://your-paid-api.com/endpoint", {
+const response = await client.request("https://your-api.com/api/your-endpoint", {
   method: "POST",
   headers: { "Content-Type": "application/json" },
-  body: JSON.stringify({ /* your request */ }),
+  body: JSON.stringify({ key: "value" }),
 });
+const data = await response.json();
+\`\`\`
+
+## Request / Response
+
+[Document your API parameters and response format here]
+
+## Error Handling
+
+### Insufficient Allowance
+
+\`\`\`bash
+npx @springmint/x402-payment --approve --token <TOKEN_ADDRESS> --network <NETWORK>
+\`\`\`
 ```
 
-And in your skill's `SKILL.md`, declare the dependency:
+### Step 2: Agent Workflow
 
-```yaml
-dependencies:
-  - x402-payment
+When an AI agent receives your skill, the complete flow is:
+
+```
+1. Agent reads SKILL.md
+       │
+2. Checks if @springmint/x402-payment is installed
+   └─ If not: runs `npm install @springmint/x402-payment`
+       │
+3. Verifies wallet: `npx @springmint/x402-payment --check`
+   └─ If no wallet: asks user to configure private key
+       │
+4. Calls your API via CLI or library
+       │
+5. Gets 402 → SDK auto-pays → gets result
+       │
+6. If allowance error: runs --approve, then retries
+```
+
+### Step 3: Publish
+
+Put your `SKILL.md` in a git repository. AI agents can use it by reading the file:
+
+```
+Read my-api-skill/SKILL.md and call the API with {"key": "value"}
 ```
 
 See [cpbox-skills/batch-balance](https://github.com/springmint/cpbox-skills) for a real-world example.

package/SKILL.md

@@ -7,7 +7,7 @@ compatibility:
   tools:
     - x402_invoke
 metadata:
-  version: 1.0.1
+  version: 1.0.2
   author: cppay.finance
   homepage: https://x402.org
   tags: [crypto, payments, x402, agents, api, usdt, usdd, usdc, tron, ethereum, evm, erc20, trc20, sdk]
@@ -146,7 +146,23 @@ If the endpoint returns an image or binary data (CLI mode only):
 
 ### Insufficient Allowance
 
-If allowance is insufficient, the tool will automatically attempt an "infinite approval" transaction. Ensure you have native tokens (TRX or BNB/ETH) for gas.
+If you get an allowance error, approve the token first:
+
+```bash
+# Check current allowance
+npx @springmint/x402-payment --allowance --token <TOKEN_ADDRESS> --network <NETWORK>
+
+# Approve token spending
+npx @springmint/x402-payment --approve --token <TOKEN_ADDRESS> --network <NETWORK>
+```
+
+Or in code:
+```ts
+import { approveToken } from "@springmint/x402-payment";
+await approveToken("evm", "0x55d3...7955", "eip155:97");
+```
+
+Ensure you have native tokens (TRX or BNB/ETH) for gas.
 
 ### Insufficient Balance
 

package/dist/cli/client.d.ts

@@ -60,3 +60,22 @@ export declare function invokeEndpoint(url: string, options?: {
     headers: Record<string, string>;
     body: any;
 }>;
+/**
+ * Check token allowance for the current wallet.
+ *
+ * Usage:
+ * ```ts
+ * const allowance = await checkAllowance("evm", "0x55d3...7955", "eip155:56");
+ * console.log(`Current allowance: ${allowance}`);
+ * ```
+ */
+export declare function checkAllowance(type: "tron" | "evm", token: string, network: string, options?: CreateClientOptions): Promise<bigint>;
+/**
+ * Approve token spending for x402 payments. Calls `ensureAllowance` on the signer.
+ *
+ * Usage:
+ * ```ts
+ * await approveToken("evm", "0x55d3...7955", "eip155:56");
+ * ```
+ */
+export declare function approveToken(type: "tron" | "evm", token: string, network: string, options?: CreateClientOptions): Promise<boolean>;

package/dist/cli/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"","sourceRoot":"","sources":["file:///Users/mac/Desktop/Work/cpbox-projects/x402-payment/src/client.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,wFAAwF;IACxF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uFAAuF;IACvF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wFAAwF;IACxF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,GAAE,mBAAwB,kDA2CvE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,GAAE,mBAAwB,uDAI5E;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,mBAAmB,CAAC;CAChC,GACL,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,GAAG,CAAA;CAAE,CAAC,CAoCzE"}
+{"version":3,"file":"","sourceRoot":"","sources":["file:///Users/mac/Desktop/Work/cpbox-projects/x402-payment/src/client.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,wFAAwF;IACxF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uFAAuF;IACvF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wFAAwF;IACxF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,GAAE,mBAAwB,kDA2CvE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,GAAE,mBAAwB,uDAI5E;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,mBAAmB,CAAC;CAChC,GACL,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,GAAG,CAAA;CAAE,CAAC,CAoCzE;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,GAAG,KAAK,EACpB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,GAAG,KAAK,EACpB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,OAAO,CAAC,CAgBlB"}

package/dist/cli/index.d.ts

@@ -1,3 +1,3 @@
 export { findPrivateKey, findApiKey } from "./config.js";
-export { createX402Client, createX402FetchClient, invokeEndpoint } from "./client.js";
+export { createX402Client, createX402FetchClient, invokeEndpoint, checkAllowance, approveToken } from "./client.js";
 export type { CreateClientOptions } from "./client.js";

package/dist/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"","sourceRoot":"","sources":["file:///Users/mac/Desktop/Work/cpbox-projects/x402-payment/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACtF,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"","sourceRoot":"","sources":["file:///Users/mac/Desktop/Work/cpbox-projects/x402-payment/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACpH,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/dist/cli/x402_invoke.js

@@ -511,6 +511,51 @@ async function invokeEndpoint(url, options = {}) {
         body,
     };
 }
+/**
+ * Check token allowance for the current wallet.
+ *
+ * Usage:
+ * ```ts
+ * const allowance = await checkAllowance("evm", "0x55d3...7955", "eip155:56");
+ * console.log(`Current allowance: ${allowance}`);
+ * ```
+ */
+async function checkAllowance(type, token, network, options = {}) {
+    const { TronClientSigner, EvmClientSigner } = await __nccwpck_require__.e(/* import() */ 743).then(__nccwpck_require__.bind(__nccwpck_require__, 3743));
+    const key = type === "tron"
+        ? (options.tronPrivateKey ?? await findPrivateKey("tron"))
+        : (options.evmPrivateKey ?? await findPrivateKey("evm"));
+    if (!key)
+        throw new Error(`No ${type.toUpperCase()} private key found.`);
+    const apiKey = options.tronGridApiKey ?? (await findApiKey());
+    if (apiKey)
+        process.env.TRON_GRID_API_KEY = apiKey;
+    const signer = type === "tron" ? new TronClientSigner(key) : new EvmClientSigner(key);
+    return signer.checkAllowance(token, BigInt(0), network);
+}
+/**
+ * Approve token spending for x402 payments. Calls `ensureAllowance` on the signer.
+ *
+ * Usage:
+ * ```ts
+ * await approveToken("evm", "0x55d3...7955", "eip155:56");
+ * ```
+ */
+async function approveToken(type, token, network, options = {}) {
+    const { TronClientSigner, EvmClientSigner } = await __nccwpck_require__.e(/* import() */ 743).then(__nccwpck_require__.bind(__nccwpck_require__, 3743));
+    const key = type === "tron"
+        ? (options.tronPrivateKey ?? await findPrivateKey("tron"))
+        : (options.evmPrivateKey ?? await findPrivateKey("evm"));
+    if (!key)
+        throw new Error(`No ${type.toUpperCase()} private key found.`);
+    const apiKey = options.tronGridApiKey ?? (await findApiKey());
+    if (apiKey)
+        process.env.TRON_GRID_API_KEY = apiKey;
+    const signer = type === "tron" ? new TronClientSigner(key) : new EvmClientSigner(key);
+    // Use max uint256 for unlimited approval
+    const maxAmount = BigInt("0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff");
+    return signer.ensureAllowance(token, maxAmount, network, "auto");
+}
 
 ;// CONCATENATED MODULE: ./src/cli.ts
 
@@ -559,6 +604,54 @@ async function main() {
         }
         process.exit(0);
     }
+    // --allowance --token <address> --network <network> [--type evm|tron]
+    if (options.allowance === "true") {
+        const token = options.token;
+        const network = options.network;
+        const type = (options.type || "evm");
+        if (!token || !network) {
+            console.error("Error: --allowance requires --token and --network");
+            process.exit(1);
+        }
+        try {
+            const allowance = await checkAllowance(type, token, network, {
+                tronPrivateKey: tronKey,
+                evmPrivateKey: evmKey,
+                tronGridApiKey: apiKey,
+            });
+            process.stdout.write(JSON.stringify({ allowance: allowance.toString() }, null, 2) + "\n");
+        }
+        catch (e) {
+            console.error(`[x402] Error: ${e.message}`);
+            process.exit(1);
+        }
+        process.exit(0);
+    }
+    // --approve --token <address> --network <network> [--type evm|tron]
+    if (options.approve === "true") {
+        const token = options.token;
+        const network = options.network;
+        const type = (options.type || "evm");
+        if (!token || !network) {
+            console.error("Error: --approve requires --token and --network");
+            process.exit(1);
+        }
+        try {
+            console.error(`[x402] Approving ${token} on ${network} (${type})...`);
+            const result = await approveToken(type, token, network, {
+                tronPrivateKey: tronKey,
+                evmPrivateKey: evmKey,
+                tronGridApiKey: apiKey,
+            });
+            console.error(`[x402] Approval ${result ? "successful" : "not needed (already approved)"}.`);
+            process.stdout.write(JSON.stringify({ approved: result }, null, 2) + "\n");
+        }
+        catch (e) {
+            console.error(`[x402] Error: ${e.message}`);
+            process.exit(1);
+        }
+        process.exit(0);
+    }
     if (!url) {
         console.error("Error: --url is required");
         process.exit(1);

package/dist/lib/client.d.ts

@@ -60,4 +60,23 @@ export declare function invokeEndpoint(url: string, options?: {
     headers: Record<string, string>;
     body: any;
 }>;
+/**
+ * Check token allowance for the current wallet.
+ *
+ * Usage:
+ * ```ts
+ * const allowance = await checkAllowance("evm", "0x55d3...7955", "eip155:56");
+ * console.log(`Current allowance: ${allowance}`);
+ * ```
+ */
+export declare function checkAllowance(type: "tron" | "evm", token: string, network: string, options?: CreateClientOptions): Promise<bigint>;
+/**
+ * Approve token spending for x402 payments. Calls `ensureAllowance` on the signer.
+ *
+ * Usage:
+ * ```ts
+ * await approveToken("evm", "0x55d3...7955", "eip155:56");
+ * ```
+ */
+export declare function approveToken(type: "tron" | "evm", token: string, network: string, options?: CreateClientOptions): Promise<boolean>;
 //# sourceMappingURL=client.d.ts.map

package/dist/lib/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,wFAAwF;IACxF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uFAAuF;IACvF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wFAAwF;IACxF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,GAAE,mBAAwB,kDA2CvE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,GAAE,mBAAwB,uDAI5E;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,mBAAmB,CAAC;CAChC,GACL,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,GAAG,CAAA;CAAE,CAAC,CAoCzE"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,wFAAwF;IACxF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uFAAuF;IACvF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wFAAwF;IACxF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,GAAE,mBAAwB,kDA2CvE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,GAAE,mBAAwB,uDAI5E;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,mBAAmB,CAAC;CAChC,GACL,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,GAAG,CAAA;CAAE,CAAC,CAoCzE;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,GAAG,KAAK,EACpB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,GAAG,KAAK,EACpB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,OAAO,CAAC,CAgBlB"}

package/dist/lib/client.js

@@ -105,4 +105,49 @@ export async function invokeEndpoint(url, options = {}) {
         body,
     };
 }
+/**
+ * Check token allowance for the current wallet.
+ *
+ * Usage:
+ * ```ts
+ * const allowance = await checkAllowance("evm", "0x55d3...7955", "eip155:56");
+ * console.log(`Current allowance: ${allowance}`);
+ * ```
+ */
+export async function checkAllowance(type, token, network, options = {}) {
+    const { TronClientSigner, EvmClientSigner } = await import("@springmint/x402");
+    const key = type === "tron"
+        ? (options.tronPrivateKey ?? await findPrivateKey("tron"))
+        : (options.evmPrivateKey ?? await findPrivateKey("evm"));
+    if (!key)
+        throw new Error(`No ${type.toUpperCase()} private key found.`);
+    const apiKey = options.tronGridApiKey ?? (await findApiKey());
+    if (apiKey)
+        process.env.TRON_GRID_API_KEY = apiKey;
+    const signer = type === "tron" ? new TronClientSigner(key) : new EvmClientSigner(key);
+    return signer.checkAllowance(token, BigInt(0), network);
+}
+/**
+ * Approve token spending for x402 payments. Calls `ensureAllowance` on the signer.
+ *
+ * Usage:
+ * ```ts
+ * await approveToken("evm", "0x55d3...7955", "eip155:56");
+ * ```
+ */
+export async function approveToken(type, token, network, options = {}) {
+    const { TronClientSigner, EvmClientSigner } = await import("@springmint/x402");
+    const key = type === "tron"
+        ? (options.tronPrivateKey ?? await findPrivateKey("tron"))
+        : (options.evmPrivateKey ?? await findPrivateKey("evm"));
+    if (!key)
+        throw new Error(`No ${type.toUpperCase()} private key found.`);
+    const apiKey = options.tronGridApiKey ?? (await findApiKey());
+    if (apiKey)
+        process.env.TRON_GRID_API_KEY = apiKey;
+    const signer = type === "tron" ? new TronClientSigner(key) : new EvmClientSigner(key);
+    // Use max uint256 for unlimited approval
+    const maxAmount = BigInt("0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff");
+    return signer.ensureAllowance(token, maxAmount, network, "auto");
+}
 //# sourceMappingURL=client.js.map

package/dist/lib/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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"}

package/dist/lib/index.d.ts

@@ -1,4 +1,4 @@
 export { findPrivateKey, findApiKey } from "./config.js";
-export { createX402Client, createX402FetchClient, invokeEndpoint } from "./client.js";
+export { createX402Client, createX402FetchClient, invokeEndpoint, checkAllowance, approveToken } from "./client.js";
 export type { CreateClientOptions } from "./client.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACtF,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACpH,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/dist/lib/index.js

@@ -1,3 +1,3 @@
 export { findPrivateKey, findApiKey } from "./config.js";
-export { createX402Client, createX402FetchClient, invokeEndpoint } from "./client.js";
+export { createX402Client, createX402FetchClient, invokeEndpoint, checkAllowance, approveToken } from "./client.js";
 //# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@springmint/x402-payment",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "x402 payment SDK - Add x402 pay-per-use capability to your AI agent skills and Node.js applications",
   "license": "MIT",
   "type": "module",