@dfm-fi/agent 0.2.1543 → 0.2.1550

package/dist/examples/fund-app-wallet.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=fund-app-wallet.d.ts.map

package/dist/examples/fund-app-wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fund-app-wallet.d.ts","sourceRoot":"","sources":["../../src/examples/fund-app-wallet.ts"],"names":[],"mappings":""}

package/dist/examples/fund-app-wallet.js

@@ -0,0 +1,39 @@
+/**
+ * Top up the app wallet from its owner — the ONE signature the app-wallet model
+ * cannot avoid, because it is the owner's money leaving the owner's wallet.
+ *
+ * The other direction (app wallet → owner) is `recover-app-wallet-assets.ts`.
+ *
+ *   DFM_API_URL=https://n2-api.dfm.finance \
+ *   DFM_AGENT_KEYPAIR_PATH=~/.config/dfm/test-6vch.json \
+ *   USDC=11.1 [SOL=0.01] npx tsx src/examples/fund-app-wallet.ts
+ */
+import { loadConfig } from '../config.js';
+import { SiwsSession } from '../session.js';
+import { DfmApiClient } from '../api-client.js';
+import { signBase64Transaction } from '../signing.js';
+import { submitSignedTx } from '../submit.js';
+async function main() {
+    const config = loadConfig();
+    const api = new DfmApiClient(config, new SiwsSession(config));
+    const usdcMicros = Math.round(Number(process.env.USDC ?? '0') * 1e6);
+    const solLamports = Math.round(Number(process.env.SOL ?? '0') * 1e9);
+    if (usdcMicros <= 0 && solLamports <= 0)
+        throw new Error('set USDC and/or SOL');
+    const prepared = await api.prepareOperatingFund({
+        ...(usdcMicros > 0 ? { usdcMicros } : {}),
+        ...(solLamports > 0 ? { solLamports } : {}),
+    });
+    const signed = signBase64Transaction(config, prepared.transaction);
+    const signature = await submitSignedTx(config, signed, prepared.blockhash, prepared.lastValidBlockHeight, 
+    // Backend broadcast: without `preparedTxId` this is the one write that
+    // demands a client RPC.
+    { api, preparedTxId: prepared.preparedTxId });
+    console.log(`funded ${prepared.operatingWalletAddress} with ${usdcMicros / 1e6} USDC ` +
+        `+ ${solLamports / 1e9} SOL — ${signature}`);
+}
+main().catch((e) => {
+    console.error('FAILED', e instanceof Error ? e.message : e);
+    process.exit(1);
+});
+//# sourceMappingURL=fund-app-wallet.js.map

package/dist/examples/fund-app-wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fund-app-wallet.js","sourceRoot":"","sources":["../../src/examples/fund-app-wallet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,GAAG,GAAG,IAAI,YAAY,CAAC,MAAM,EAAE,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;IACrE,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;IACrE,IAAI,UAAU,IAAI,CAAC,IAAI,WAAW,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAEhF,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,oBAAoB,CAAC;QAC9C,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,GAAG,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5C,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IACnE,MAAM,SAAS,GAAG,MAAM,cAAc,CACpC,MAAM,EACN,MAAM,EACN,QAAQ,CAAC,SAAS,EAClB,QAAQ,CAAC,oBAAoB;IAC7B,uEAAuE;IACvE,wBAAwB;IACxB,EAAE,GAAG,EAAE,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE,CAC7C,CAAC;IACF,OAAO,CAAC,GAAG,CACT,UAAU,QAAQ,CAAC,sBAAsB,SAAS,UAAU,GAAG,GAAG,QAAQ;QACxE,KAAK,WAAW,GAAG,GAAG,UAAU,SAAS,EAAE,CAC9C,CAAC;AACJ,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;IACjB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/examples/recover-app-wallet-assets.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=recover-app-wallet-assets.d.ts.map

package/dist/examples/recover-app-wallet-assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recover-app-wallet-assets.d.ts","sourceRoot":"","sources":["../../src/examples/recover-app-wallet-assets.ts"],"names":[],"mappings":""}

package/dist/examples/recover-app-wallet-assets.js

@@ -0,0 +1,86 @@
+/**
+ * Recover what a test cycle stranded in the app wallet: every non-USDC, non-share
+ * token goes OUT to one destination, in one pass, so it can be swapped back to
+ * USDC from a wallet whose key is local (`contracts/scripts/swap-wallet-tokens-to-usdc.js`).
+ *
+ * An in-kind cancel and the per-leg surplus refunds pay the user in BASKET TOKENS,
+ * and the app wallet has no swap surface — so the value sits there until it is
+ * moved. This is the move.
+ *
+ * Dry-run by default; `--execute` sends. Fund shares are skipped (redeem them, do
+ * not transfer them) and so is USDC (it is already the thing we want).
+ *
+ *   DFM_API_URL=https://n2-api.dfm.finance \
+ *   DFM_AGENT_KEYPAIR_PATH=~/.config/dfm/test-6vch.json \
+ *   DEST=<address> MIN_USD=0.05 npx tsx src/examples/recover-app-wallet-assets.ts [--execute]
+ *
+ * Prints the `MINTS=` line the swap script takes, so the two steps chain.
+ */
+import { loadConfig } from '../config.js';
+import { SiwsSession } from '../session.js';
+import { DfmApiClient } from '../api-client.js';
+const USDC = 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v';
+async function main() {
+    const execute = process.argv.includes('--execute');
+    const config = loadConfig();
+    const api = new DfmApiClient(config, new SiwsSession(config));
+    // No DEST = let the server resolve it (saved withdrawal wallet, else the
+    // owner). NAMING the sign-in wallet is refused ("it only identifies you"),
+    // so for a wallet whose owner IS its sign-in identity this is the only way out.
+    const dest = process.env.DEST;
+    const minUsd = Number(process.env.MIN_USD ?? '0.05');
+    const only = process.env.ONLY_MINT;
+    const assets = (await api.authRequest('/agent/operating/assets', { method: 'GET' }));
+    // Dust below the floor costs more in rent and fees than it returns; a fund
+    // share is a CLAIM, not value in hand — it leaves through redeem, never here.
+    const movable = assets.assets.filter((a) => a.mint !== USDC &&
+        !a.isFundShare &&
+        (a.valueUsd ?? 0) >= minUsd &&
+        (!only || a.mint === only));
+    const total = movable.reduce((sum, a) => sum + (a.valueUsd ?? 0), 0);
+    console.log(`app wallet ${assets.operatingWalletAddress} → ${dest ?? '(server-resolved destination)'}`);
+    console.log(`${movable.length} tokens worth ~$${total.toFixed(2)} (floor $${minUsd})\n`);
+    for (const a of movable)
+        console.log(`  ${a.mint.slice(0, 8)}… ${a.uiAmount} ≈ $${(a.valueUsd ?? 0).toFixed(3)}`);
+    // The destination has to pay for its own swaps afterwards, and a test wallet
+    // that just spent its SOL on rent cannot. Move gas in the same pass.
+    const solLamports = Number(process.env.SOL_LAMPORTS ?? '0');
+    if (!execute) {
+        if (solLamports > 0)
+            console.log(`\nwould also send ${(solLamports / 1e9).toFixed(4)} SOL for gas`);
+        console.log('\nDRY-RUN — nothing sent. Re-run with --execute.');
+    }
+    else {
+        console.log('');
+        if (solLamports > 0) {
+            try {
+                const r = await api.authRequest('/agent/operating/float/withdraw', {
+                    method: 'POST',
+                    body: JSON.stringify({ solLamports, ...(dest ? { destination: dest } : {}) }),
+                });
+                console.log(`sent ${(solLamports / 1e9).toFixed(4)} SOL for gas — ${r.signature}`);
+            }
+            catch (e) {
+                console.log(`FAILED SOL gas — ${e.message.slice(0, 140)}`);
+            }
+        }
+        for (const a of movable) {
+            try {
+                const r = await api.authRequest('/agent/operating/assets/withdraw', {
+                    method: 'POST',
+                    body: JSON.stringify({ mint: a.mint, all: true, ...(dest ? { destination: dest } : {}) }),
+                });
+                console.log(`sent ${a.mint.slice(0, 8)}… ${r.sentAmount} — ${r.signature}`);
+            }
+            catch (e) {
+                console.log(`FAILED ${a.mint.slice(0, 8)}… ${e.message.slice(0, 140)}`);
+            }
+        }
+    }
+    console.log(`\nMINTS="${movable.map((a) => `${a.label ?? a.mint.slice(0, 4)}:${a.mint}`).join(',')}"`);
+}
+main().catch((e) => {
+    console.error('FAILED', e instanceof Error ? e.message : e);
+    process.exit(1);
+});
+//# sourceMappingURL=recover-app-wallet-assets.js.map

package/dist/examples/recover-app-wallet-assets.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dfm-fi/agent",
-  "version": "0.2.1543",
+  "version": "0.2.1550",
   "description": "DFM v2 MCP server — drive the full DTF launch → deposit → redeem (+ manage) lifecycle from an AI agent against the live API.",
   "type": "module",
   "bin": {