@nickthelegend69/fund402 0.1.0 → 0.1.1

package/README.md

@@ -128,6 +128,12 @@ const data = await res.json();   // paid + served — the agent's own balance ca
 Prefer Axios? `withPaymentInterceptor(config)` returns an `AxiosInstance` with the
 same behaviour (Axios is an optional peer dependency).
 
+**Tiers & collateral.** Trusted (Tier-3) agents borrow with **zero collateral**.
+New/established (Tier-1/2) agents must post 150% collateral — `fund402Fetch`
+**auto-approves** the vault to escrow it before borrowing (`collateralRatio`, default
+`1.5`; set `autoApprove: false` to manage the allowance yourself, or `collateralRatio: 0`
+for Tier-3).
+
 ---
 
 ## How settlement works (and why you can trust it)
@@ -165,10 +171,17 @@ hits the endpoint → gets a 402 → borrows from the pool (the vault fronts the
 the merchant) → retries → the server verifies the settlement on-chain via CSPR.cloud
 → serves the resource.
 
-Last live run — agent `01baa8d8…` (Tier-3, **zero collateral**) borrowed `1000000`
-F402; the pool fronted it to the merchant and the server served the resource after
-verifying it on-chain:
-**[settlement deploy `96f30ddf…` ↗](https://testnet.cspr.live/deploy/96f30ddfac9b3b8bc04a9fe274b1c006aff398ac624e7360669a2c1f3dc28264)** (`status: processed`).
+Both credit paths are proven live through the SDK:
+
+- **Tier-3 (zero collateral)** — agent `01baa8d8…` borrowed `1000000` F402; the pool
+  fronted it to the merchant.
+  [settlement deploy `96f30ddf…` ↗](https://testnet.cspr.live/deploy/96f30ddfac9b3b8bc04a9fe274b1c006aff398ac624e7360669a2c1f3dc28264) (`status: processed`).
+- **Tier-1 (150% collateral)** — agent `017e90a1…` had `fund402Fetch` auto-approve and
+  **escrow `1500000` collateral** ([approve `f088362a…`](https://testnet.cspr.live/deploy/f088362a89720107dfe475ba8bc0660dbdb278cf25c3d633cf4e846414d8aa47)),
+  then borrow; verified on-chain (`collateral=1500000`).
+  [settlement deploy `a9dd1581…` ↗](https://testnet.cspr.live/deploy/a9dd158199ca65fda900863cd43db577983c1dcf3d6661409bf8d4c56bab649f) (`status: processed`).
+
+Run them yourself: `npm run test:e2e` (Tier-3) and `npm run test:e2e:collateral` (Tier-1).
 
 ## API
 

package/dist/casper.js

@@ -118,7 +118,9 @@ async function ensureCollateralAllowance(cfg, spender, amount) {
         spender: pkgKey(spender.vaultContractHash),
         amount: casper_js_sdk_1.CLValue.newCLUInt256(amount.toString()),
     }));
-    const payment = casper_js_sdk_1.ExecutableDeployItem.standardPayment("2000000000");
+    // 5 CSPR — the gas the proven live approves use; lower (e.g. 2 CSPR) is rejected
+    // by Condor at submission as Invalid Deploy.
+    const payment = casper_js_sdk_1.ExecutableDeployItem.standardPayment("5000000000");
     const deploy = casper_js_sdk_1.Deploy.makeDeploy(header, payment, session);
     deploy.sign(signer);
     const result = await client.putDeploy(deploy);

package/dist/client.d.ts

@@ -16,6 +16,8 @@ export interface Fund402ClientConfig {
     keyAlgorithm?: KeyAlgorithm;
     /** Over-collateralisation ratio the agent posts (vault re-checks on-chain). Default 1.5. */
     collateralRatio?: number;
+    /** Auto-approve the vault to escrow collateral before a Tier-1/2 borrow. Default true. */
+    autoApprove?: boolean;
     /** Gas (motes) for the borrow_and_pay deploy. Default 5 CSPR. */
     borrowGasMotes?: string;
     /** Underlying fetch implementation. Default global fetch. */
@@ -23,7 +25,7 @@ export interface Fund402ClientConfig {
     onEvent?: (event: Fund402Event) => void;
 }
 export interface Fund402Event {
-    type: "intercepted_402" | "borrowing" | "borrow_submitted" | "payment_settled" | "payment_sent" | "request_retried" | "payment_confirmed";
+    type: "intercepted_402" | "approving" | "approve_submitted" | "borrowing" | "borrow_submitted" | "payment_settled" | "payment_sent" | "request_retried" | "payment_confirmed";
     data: Record<string, unknown>;
     timestamp: number;
 }

package/dist/client.js

@@ -79,6 +79,20 @@ async function payViaPool(config, option, resource) {
     const amount = BigInt(option.amount);
     const ratio = config.collateralRatio ?? 1.5;
     const collateral = (amount * BigInt(Math.round(ratio * 100))) / 100n;
+    // Tier-1/2 collateralized borrow: the vault escrows `collateral` via transfer_from,
+    // so the agent must approve it on the CEP-18 asset first. Tier-3 borrows post zero
+    // collateral and skip this entirely.
+    if (collateral > 0n && config.autoApprove !== false) {
+        const asset = (option.asset ?? "").replace(/^0x/, "");
+        if (!asset)
+            throw new Error("402 challenge has no `asset` — cannot approve collateral");
+        emit(config, "approving", { asset, collateral: collateral.toString() });
+        const { deployHash: approveHash } = await (0, casper_1.ensureCollateralAllowance)({ ...wiring, assetPackageHash: asset }, { vaultContractHash: wiring.vaultContractHash }, collateral);
+        emit(config, "approve_submitted", { deployHash: approveHash });
+        const okApprove = await (0, casper_1.waitForDeploy)(wiring, approveHash);
+        if (!okApprove)
+            throw new Error(`collateral approve deploy failed: ${approveHash}`);
+    }
     emit(config, "borrowing", { amount: amount.toString(), collateral: collateral.toString() });
     const { deployHash } = await (0, casper_1.borrowAndPayOnChain)(wiring, {
         merchant: option.payTo,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nickthelegend69/fund402",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Create x402-gated HTTP endpoints settled by the Fund402 lending pool on Casper — and the agent client that pays them with just-in-time credit. Drop-in middleware for Express, Hono and Next.js.",
   "keywords": [
     "x402",
@@ -36,7 +36,8 @@
     "build": "tsc -p tsconfig.json",
     "prepublishOnly": "npm run build",
     "test": "npm run build && node test/server.test.mjs && node test/eip712.test.mjs",
-    "test:e2e": "npm run build && node test/e2e-live.mjs"
+    "test:e2e": "npm run build && node test/e2e-live.mjs",
+    "test:e2e:collateral": "npm run build && node test/e2e-collateral.mjs"
   },
   "dependencies": {
     "@noble/hashes": "^1.4.0",