@nickthelegend69/fund402 0.1.1 → 0.1.3

package/README.md

@@ -151,17 +151,30 @@ for Tier-3).
 `verifyPoolSettlement` is resilient to indexer lag — it polls a bounded window while
 the deploy is still propagating, and fails fast on an executed on-chain failure.
 
+## Yield-bearing pool
+
+The vault charges a **5% JIT credit fee** on every borrow. On repayment the agent pays
+back principal **+ fee**, and the fee accrues to the pool's value — so **LPs earn yield**:
+deposits are minted as shares, and a share redeems for more than it cost as fees pile up.
+Agents can settle their newest loan with **`repayLatestOnChain`** (no loan id needed),
+which makes auto-repay-from-earnings trivial.
+
+**Proven live (casper-test):** an LP deposited `2_000_000`, an agent borrowed `1_000_000`
+and repaid via `repay_latest`, the pool grew to `2_050_000`, and the LP **withdrew
+`2_050_000` for its `2_000_000` deposit — `+50_000` realized yield.**
+[repay `80e90a43…`](https://testnet.cspr.live/deploy/80e90a43120b40524038a405088f3f83c4ce45674a9ff3e28c577a20552cba9e) ·
+[LP withdraw `44318b5b…`](https://testnet.cspr.live/deploy/44318b5b303dab8dbbb3c3b26ac0f148bf7b44701996fbd446f17f9f7622023c)
+
 ## Live deployment (casper-test)
 
 | | |
 |---|---|
-| Vault (lending pool) package | `664d99de146b9b573161a387d89fefc649677351d8a6d2acbe22109bf88f6b12` |
+| Vault (yield-bearing lending pool) package | `ca4086d3a7b1abf000d0a79e23a237bb484a14807e9438f2c56f3461073e1b2f` |
 | CEP-18 asset (Fund402 USDC / F402) | `389cedc529cc553e2639884c9dcc5e6dcbeb3920f7f5ca5a39bf7f7b866bccd0` |
 | Network | `casper:casper-test` |
 | Facilitator | `https://x402-facilitator.cspr.cloud` |
 
-These are the defaults the SDK ships with — point `vaultContract` / `asset` at your
-own deployment for production.
+Point `vaultContract` / `asset` at your own deployment for production.
 
 ## Verified live ✅
 
@@ -194,8 +207,9 @@ Run them yourself: `npm run test:e2e` (Tier-3) and `npm run test:e2e:collateral`
 · `decodeChallenge` · `selectCasperOption` · `testnetClient` / `mainnetClient`.
 
 **On-chain primitives:** `borrowAndPayOnChain` · `repayLoanOnChain` ·
-`ensureCollateralAllowance` · `buildExactPayload` · `waitForDeploy` ·
-`agentTaggedAddress` · `transferAuthorizationDigest`.
+`repayLatestOnChain` (repay your newest loan — no loan id) · `ensureCollateralAllowance`
+· `buildExactPayload` · `waitForDeploy` · `agentTaggedAddress` ·
+`transferAuthorizationDigest`.
 
 ## ⚠️ Security
 

package/dist/casper.d.ts

@@ -32,6 +32,15 @@ export declare function borrowAndPayOnChain(cfg: CasperWiringConfig, args: {
 export declare function repayLoanOnChain(cfg: CasperWiringConfig, loanId: number): Promise<{
     deployHash: string;
 }>;
+/**
+ * Repay the agent's **most recent** open loan without needing its id (vault
+ * `repay_latest`). Pulls back principal + the JIT fee — the fee accrues to the pool
+ * as LP yield. The agent must first `approve` the vault for principal + fee
+ * (see ensureCollateralAllowance) and hold that much of the asset.
+ */
+export declare function repayLatestOnChain(cfg: CasperWiringConfig): Promise<{
+    deployHash: string;
+}>;
 /**
  * Approve the vault to pull `amount` of the CEP-18 asset from the agent (needed
  * before a collateralized borrow_and_pay can escrow, and before repay_loan can
@@ -54,6 +63,21 @@ export declare function waitForDeploy(cfg: Pick<CasperWiringConfig, "nodeUrl">,
     tries?: number;
     intervalMs?: number;
 }): Promise<boolean>;
+/**
+ * LP deposits CEP-18 liquidity into the pool (minted as shares). The LP must first
+ * `approve` the vault for `amount` on the asset (see ensureCollateralAllowance). As
+ * borrow fees accrue, each share redeems for more — that's the LP's yield.
+ */
+export declare function depositLiquidityOnChain(cfg: CasperWiringConfig, amount: bigint): Promise<{
+    deployHash: string;
+}>;
+/**
+ * LP burns `shares` and withdraws the CEP-18 they redeem for — including accrued
+ * yield (limited to the pool's free cash).
+ */
+export declare function withdrawLiquidityOnChain(cfg: CasperWiringConfig, shares: bigint): Promise<{
+    deployHash: string;
+}>;
 /** Casper account-hash ("00" + 32-byte hash) for the agent's public key. */
 export declare function agentTaggedAddress(agentPublicKey: string): string;
 /**

package/dist/casper.js

@@ -11,8 +11,11 @@ exports.rpc = rpc;
 exports.loadPrivateKey = loadPrivateKey;
 exports.borrowAndPayOnChain = borrowAndPayOnChain;
 exports.repayLoanOnChain = repayLoanOnChain;
+exports.repayLatestOnChain = repayLatestOnChain;
 exports.ensureCollateralAllowance = ensureCollateralAllowance;
 exports.waitForDeploy = waitForDeploy;
+exports.depositLiquidityOnChain = depositLiquidityOnChain;
+exports.withdrawLiquidityOnChain = withdrawLiquidityOnChain;
 exports.agentTaggedAddress = agentTaggedAddress;
 exports.buildExactPayload = buildExactPayload;
 const casper_js_sdk_1 = require("casper-js-sdk");
@@ -100,6 +103,28 @@ async function repayLoanOnChain(cfg, loanId) {
     const result = await client.putDeploy(deploy);
     return { deployHash: result.deployHash.toHex() };
 }
+/**
+ * Repay the agent's **most recent** open loan without needing its id (vault
+ * `repay_latest`). Pulls back principal + the JIT fee — the fee accrues to the pool
+ * as LP yield. The agent must first `approve` the vault for principal + fee
+ * (see ensureCollateralAllowance) and hold that much of the asset.
+ */
+async function repayLatestOnChain(cfg) {
+    const client = rpc(cfg.nodeUrl);
+    const algo = cfg.keyAlgorithm ?? casper_js_sdk_1.KeyAlgorithm.ED25519;
+    const signer = await loadPrivateKey(cfg.agentSecretKey, algo);
+    const sender = casper_js_sdk_1.PublicKey.fromHex(cfg.agentPublicKey);
+    const header = casper_js_sdk_1.DeployHeader.default();
+    header.account = sender;
+    header.chainName = cfg.chainName;
+    header.ttl = new casper_js_sdk_1.Duration(casper_js_sdk_1.DEFAULT_DEPLOY_TTL);
+    const session = callPkg(cfg.vaultContractHash, "repay_latest", casper_js_sdk_1.Args.fromMap({}));
+    const payment = casper_js_sdk_1.ExecutableDeployItem.standardPayment("3000000000");
+    const deploy = casper_js_sdk_1.Deploy.makeDeploy(header, payment, session);
+    deploy.sign(signer);
+    const result = await client.putDeploy(deploy);
+    return { deployHash: result.deployHash.toHex() };
+}
 /**
  * Approve the vault to pull `amount` of the CEP-18 asset from the agent (needed
  * before a collateralized borrow_and_pay can escrow, and before repay_loan can
@@ -150,6 +175,41 @@ async function waitForDeploy(cfg, deployHash, { tries = 60, intervalMs = 3000 }
     }
     return false;
 }
+/**
+ * LP deposits CEP-18 liquidity into the pool (minted as shares). The LP must first
+ * `approve` the vault for `amount` on the asset (see ensureCollateralAllowance). As
+ * borrow fees accrue, each share redeems for more — that's the LP's yield.
+ */
+async function depositLiquidityOnChain(cfg, amount) {
+    const client = rpc(cfg.nodeUrl);
+    const signer = await loadPrivateKey(cfg.agentSecretKey, cfg.keyAlgorithm ?? casper_js_sdk_1.KeyAlgorithm.ED25519);
+    const header = casper_js_sdk_1.DeployHeader.default();
+    header.account = casper_js_sdk_1.PublicKey.fromHex(cfg.agentPublicKey);
+    header.chainName = cfg.chainName;
+    header.ttl = new casper_js_sdk_1.Duration(casper_js_sdk_1.DEFAULT_DEPLOY_TTL);
+    const session = callPkg(cfg.vaultContractHash, "deposit_liquidity", casper_js_sdk_1.Args.fromMap({ amount: casper_js_sdk_1.CLValue.newCLUInt256(amount.toString()) }));
+    const deploy = casper_js_sdk_1.Deploy.makeDeploy(header, casper_js_sdk_1.ExecutableDeployItem.standardPayment("4000000000"), session);
+    deploy.sign(signer);
+    const result = await client.putDeploy(deploy);
+    return { deployHash: result.deployHash.toHex() };
+}
+/**
+ * LP burns `shares` and withdraws the CEP-18 they redeem for — including accrued
+ * yield (limited to the pool's free cash).
+ */
+async function withdrawLiquidityOnChain(cfg, shares) {
+    const client = rpc(cfg.nodeUrl);
+    const signer = await loadPrivateKey(cfg.agentSecretKey, cfg.keyAlgorithm ?? casper_js_sdk_1.KeyAlgorithm.ED25519);
+    const header = casper_js_sdk_1.DeployHeader.default();
+    header.account = casper_js_sdk_1.PublicKey.fromHex(cfg.agentPublicKey);
+    header.chainName = cfg.chainName;
+    header.ttl = new casper_js_sdk_1.Duration(casper_js_sdk_1.DEFAULT_DEPLOY_TTL);
+    const session = callPkg(cfg.vaultContractHash, "withdraw_liquidity", casper_js_sdk_1.Args.fromMap({ shares: casper_js_sdk_1.CLValue.newCLUInt256(shares.toString()) }));
+    const deploy = casper_js_sdk_1.Deploy.makeDeploy(header, casper_js_sdk_1.ExecutableDeployItem.standardPayment("4000000000"), session);
+    deploy.sign(signer);
+    const result = await client.putDeploy(deploy);
+    return { deployHash: result.deployHash.toHex() };
+}
 /** Casper account-hash ("00" + 32-byte hash) for the agent's public key. */
 function agentTaggedAddress(agentPublicKey) {
     const pk = casper_js_sdk_1.PublicKey.fromHex(agentPublicKey);

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export * from "./types";
 export { paywall, buildPaymentRequirements, challengeBody, decodePaymentSignature, verifyPoolSettlement, verifyWithFacilitator, explorerTx, type PaywallConfig, type Fund402Paywall, type VerifyResult, type GuardResult, type RequestLike, type HttpResponseLike, } from "./server";
 export { fund402Fetch, withPaymentInterceptor, payViaPool, decodeChallenge, selectCasperOption, testnetClient, mainnetClient, type Fund402ClientConfig, type Fund402Event, } from "./client";
-export { borrowAndPayOnChain, repayLoanOnChain, ensureCollateralAllowance, buildExactPayload, waitForDeploy, agentTaggedAddress, loadPrivateKey, rpc, type CasperWiringConfig, } from "./casper";
+export { borrowAndPayOnChain, repayLoanOnChain, repayLatestOnChain, depositLiquidityOnChain, withdrawLiquidityOnChain, ensureCollateralAllowance, buildExactPayload, waitForDeploy, agentTaggedAddress, loadPrivateKey, rpc, type CasperWiringConfig, } from "./casper";
 export { transferAuthorizationDigest, randomNonce, bytesToHex } from "./eip712";
 export { expressPaywall } from "./adapters/express";
 export { honoPaywall } from "./adapters/hono";

package/dist/index.js

@@ -25,7 +25,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.withPaywall = exports.honoPaywall = exports.expressPaywall = exports.bytesToHex = exports.randomNonce = exports.transferAuthorizationDigest = exports.rpc = exports.loadPrivateKey = exports.agentTaggedAddress = exports.waitForDeploy = exports.buildExactPayload = exports.ensureCollateralAllowance = exports.repayLoanOnChain = exports.borrowAndPayOnChain = exports.mainnetClient = exports.testnetClient = exports.selectCasperOption = exports.decodeChallenge = exports.payViaPool = exports.withPaymentInterceptor = exports.fund402Fetch = exports.explorerTx = exports.verifyWithFacilitator = exports.verifyPoolSettlement = exports.decodePaymentSignature = exports.challengeBody = exports.buildPaymentRequirements = exports.paywall = void 0;
+exports.withPaywall = exports.honoPaywall = exports.expressPaywall = exports.bytesToHex = exports.randomNonce = exports.transferAuthorizationDigest = exports.rpc = exports.loadPrivateKey = exports.agentTaggedAddress = exports.waitForDeploy = exports.buildExactPayload = exports.ensureCollateralAllowance = exports.withdrawLiquidityOnChain = exports.depositLiquidityOnChain = exports.repayLatestOnChain = exports.repayLoanOnChain = exports.borrowAndPayOnChain = exports.mainnetClient = exports.testnetClient = exports.selectCasperOption = exports.decodeChallenge = exports.payViaPool = exports.withPaymentInterceptor = exports.fund402Fetch = exports.explorerTx = exports.verifyWithFacilitator = exports.verifyPoolSettlement = exports.decodePaymentSignature = exports.challengeBody = exports.buildPaymentRequirements = exports.paywall = void 0;
 __exportStar(require("./types"), exports);
 // Server
 var server_1 = require("./server");
@@ -49,6 +49,9 @@ Object.defineProperty(exports, "mainnetClient", { enumerable: true, get: functio
 var casper_1 = require("./casper");
 Object.defineProperty(exports, "borrowAndPayOnChain", { enumerable: true, get: function () { return casper_1.borrowAndPayOnChain; } });
 Object.defineProperty(exports, "repayLoanOnChain", { enumerable: true, get: function () { return casper_1.repayLoanOnChain; } });
+Object.defineProperty(exports, "repayLatestOnChain", { enumerable: true, get: function () { return casper_1.repayLatestOnChain; } });
+Object.defineProperty(exports, "depositLiquidityOnChain", { enumerable: true, get: function () { return casper_1.depositLiquidityOnChain; } });
+Object.defineProperty(exports, "withdrawLiquidityOnChain", { enumerable: true, get: function () { return casper_1.withdrawLiquidityOnChain; } });
 Object.defineProperty(exports, "ensureCollateralAllowance", { enumerable: true, get: function () { return casper_1.ensureCollateralAllowance; } });
 Object.defineProperty(exports, "buildExactPayload", { enumerable: true, get: function () { return casper_1.buildExactPayload; } });
 Object.defineProperty(exports, "waitForDeploy", { enumerable: true, get: function () { return casper_1.waitForDeploy; } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nickthelegend69/fund402",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "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",