@subly_fi/pay 0.4.0 → 0.4.1

package/README.md

@@ -26,11 +26,11 @@ export SUBLY_DEMO_AGENT_KEYPAIR_PATH=~/.subly/agent.json
 ```
 
 Send USDC (Solana mainnet) to the printed address — no SOL needed, fees are
-sponsored — then deposit (vault minimum 1 USDC; deposit self-registers the
-wallet):
+sponsored — then deposit (vault minimum is just over 1 USDC: share rounding
+refuses exactly 1.000000; deposit self-registers the wallet):
 
 ```bash
-npx -y @subly_fi/pay deposit 1000000   # 1 USDC
+npx -y @subly_fi/pay deposit 1010000   # 1.01 USDC
 ```
 
 ## Use it

package/dist/deposit.js

@@ -993,7 +993,7 @@ var OnboardingError = class extends Error {
 };
 async function ensureWalletOnboarded(params) {
   const fetchImpl = params.fetchImpl ?? fetch;
-  const baseUrl = params.facilitatorBaseUrl.replace(/\/$/, "");
+  const baseUrl = params.relayerBaseUrl.replace(/\/$/, "");
   const post = async (step, path, body) => {
     const url = `${baseUrl}${path}`;
     const serialized = JSON.stringify(body);
@@ -1095,7 +1095,7 @@ var VaultFlowClient = class {
   pollTimeoutMs;
   pollIntervalMs;
   constructor(config) {
-    this.baseUrl = config.facilitatorBaseUrl.replace(/\/$/, "");
+    this.baseUrl = config.relayerBaseUrl.replace(/\/$/, "");
     this.signer = config.signer;
     this.fetchImpl = config.fetchImpl ?? fetch;
     this.lookupTablesFor = config.lookupTablesFor ?? ((serializedTransaction) => fetchLookupTablesForTransaction(config.rpc, serializedTransaction));
@@ -1353,14 +1353,14 @@ var rpc = createRpc(
   process.env.SOLANA_RPC_URL ?? "https://api.mainnet-beta.solana.com"
 );
 var vaultFlows = new VaultFlowClient({
-  facilitatorBaseUrl: relayerBaseUrl,
+  relayerBaseUrl,
   signer,
   rpc
 });
 console.log(`[deposit] agent wallet: ${signer.walletAddress}`);
 console.log(`[deposit] relayer:  ${relayerBaseUrl}`);
 console.log("\n[deposit] step 0: ensure the wallet is registered (self-serve)");
-await ensureWalletOnboarded({ facilitatorBaseUrl: relayerBaseUrl, signer });
+await ensureWalletOnboarded({ relayerBaseUrl, signer });
 console.log("[deposit] wallet registered and synced");
 console.log(
   `

package/dist/mcp-server.js

@@ -1006,7 +1006,7 @@ var OnboardingError = class extends Error {
 };
 async function ensureWalletOnboarded(params) {
   const fetchImpl = params.fetchImpl ?? fetch;
-  const baseUrl = params.facilitatorBaseUrl.replace(/\/$/, "");
+  const baseUrl = params.relayerBaseUrl.replace(/\/$/, "");
   const post = async (step, path, body) => {
     const url = `${baseUrl}${path}`;
     const serialized = JSON.stringify(body);
@@ -1576,7 +1576,7 @@ var VaultFlowClient = class {
   pollTimeoutMs;
   pollIntervalMs;
   constructor(config) {
-    this.baseUrl = config.facilitatorBaseUrl.replace(/\/$/, "");
+    this.baseUrl = config.relayerBaseUrl.replace(/\/$/, "");
     this.signer = config.signer;
     this.fetchImpl = config.fetchImpl ?? fetch;
     this.lookupTablesFor = config.lookupTablesFor ?? ((serializedTransaction) => fetchLookupTablesForTransaction(config.rpc, serializedTransaction));
@@ -1783,12 +1783,12 @@ var SERVER_INSTRUCTIONS = `Subly lets an agent pay for ANY standard x402 (HTTP 4
 One-time setup: the operator needs a Solana keypair for the agent wallet. Subly does NOT create wallets; make one with \`solana-keygen new -o agent.json\` (or export a keypair from an existing wallet) and point SUBLY_DEMO_AGENT_KEYPAIR_PATH at it. The private key never leaves that file; this server only signs locally with it. Then fund the wallet with USDC on Solana mainnet \u2014 no SOL is ever needed, all vault transaction fees are sponsored.
 
 From there the agent can do everything with these tools:
-1. deposit_to_subly_vault(amountRawUsdc) puts wallet USDC into the vault (minimum 1 USDC = 1000000 raw) so it starts earning yield.
+1. deposit_to_subly_vault(amountRawUsdc) puts wallet USDC into the vault (minimum just over 1 USDC, e.g. 1010000 raw) so it starts earning yield.
 2. get_subly_yield_budget() shows the principal, position value, and the spendable yield a payment can use right now.
 3. fetch_with_subly_payment(url) GETs or POSTs a paid resource from any x402 seller (e.g. Nansen): it realizes just enough yield to the agent's USDC ATA and pays the seller's standard x402 challenge, returning the body plus the payment details. If it returns insufficient_yield, that is expected \u2014 yield accrues over time; wait, do not loop.
 4. withdraw_from_subly_vault(amountRawUsdc) exits: moves vault funds (principal included) back to the agent wallet's USDC account.`;
 async function runMcpPaymentServer(config) {
-  const { payer: payer2, signer: signer2, facilitatorBaseUrl, defaultMaxAmountRawUsdc: defaultMaxAmountRawUsdc2 } = config;
+  const { payer: payer2, signer: signer2, relayerBaseUrl: relayerBaseUrl2, defaultMaxAmountRawUsdc: defaultMaxAmountRawUsdc2 } = config;
   const vaultFlows = config.vaultFlows ?? null;
   const server = new Server(
     { name: "subly-payments", version: config.serverVersion ?? "0.3.0" },
@@ -1797,13 +1797,13 @@ async function runMcpPaymentServer(config) {
   const vaultTools = vaultFlows === null ? [] : [
     {
       name: DEPOSIT_TOOL_NAME,
-      description: "Deposit USDC from the agent wallet into the Subly/Kamino vault so it starts earning the yield that funds x402 payments. The transaction fee is sponsored \u2014 the agent wallet needs USDC only, never SOL. The vault minimum deposit is 1 USDC (1000000 raw). The deposited amount becomes protected principal: payments can only ever spend the yield on top of it.",
+      description: "Deposit USDC from the agent wallet into the Subly/Kamino vault so it starts earning the yield that funds x402 payments. The transaction fee is sponsored \u2014 the agent wallet needs USDC only, never SOL. The vault minimum is just over 1 USDC: share rounding refuses exactly 1000000 raw, so deposit e.g. 1010000 (1.01 USDC) or more. The deposited amount becomes protected principal: payments can only ever spend the yield on top of it.",
       inputSchema: {
         type: "object",
         properties: {
           amountRawUsdc: {
             type: "string",
-            description: 'Amount to deposit in raw USDC units (6 decimals, e.g. "1000000" = 1 USDC). Must be at least 1000000.'
+            description: 'Amount to deposit in raw USDC units (6 decimals, e.g. "1010000" = 1.01 USDC). Must exceed the 1 USDC vault minimum by a small rounding margin.'
           }
         },
         required: ["amountRawUsdc"]
@@ -1958,7 +1958,7 @@ async function runMcpPaymentServer(config) {
     ];
     if (vaultFlows !== null && vaultToolNames.includes(request.params.name)) {
       try {
-        await ensureWalletOnboarded({ facilitatorBaseUrl, signer: signer2 });
+        await ensureWalletOnboarded({ relayerBaseUrl: relayerBaseUrl2, signer: signer2 });
       } catch {
       }
       if (request.params.name === BUDGET_TOOL_NAME) {
@@ -2098,7 +2098,7 @@ async function runMcpPaymentServer(config) {
     }
   });
   try {
-    await ensureWalletOnboarded({ facilitatorBaseUrl, signer: signer2 });
+    await ensureWalletOnboarded({ relayerBaseUrl: relayerBaseUrl2, signer: signer2 });
     console.error("[subly-mcp] wallet registered and synced at the relayer");
   } catch (error) {
     console.error(
@@ -2108,7 +2108,7 @@ async function runMcpPaymentServer(config) {
   const transport = new StdioServerTransport();
   await server.connect(transport);
   console.error(
-    `[subly-mcp] ready: agent wallet ${signer2.walletAddress}, relayer ${facilitatorBaseUrl}, default cap ${formatRawUsdcAmount(defaultMaxAmountRawUsdc2)} USDC`
+    `[subly-mcp] ready: agent wallet ${signer2.walletAddress}, relayer ${relayerBaseUrl2}, default cap ${formatRawUsdcAmount(defaultMaxAmountRawUsdc2)} USDC`
   );
 }
 
@@ -2128,7 +2128,7 @@ var RelayerYieldRealizer = class {
   vaultFlows;
   constructor(config) {
     this.vaultFlows = new VaultFlowClient({
-      facilitatorBaseUrl: config.facilitatorBaseUrl,
+      relayerBaseUrl: config.relayerBaseUrl,
       signer: config.signer,
       rpc: config.rpc,
       ...config.fetchImpl === void 0 ? {} : { fetchImpl: config.fetchImpl },
@@ -2225,7 +2225,7 @@ function errorCodeFrom(detail) {
 // ../../src/client/relayer-payer.ts
 function createRelayerX402Payer(config) {
   const realizer = new RelayerYieldRealizer({
-    facilitatorBaseUrl: config.facilitatorBaseUrl,
+    relayerBaseUrl: config.relayerBaseUrl,
     signer: config.signer,
     rpc: config.rpc
   });
@@ -2388,7 +2388,7 @@ var agentSecretKey = loadSecretKeyBytes({
 var signer = new LocalKeypairAgentWalletSigner(keyPairSigner);
 var rpc = createRpc(rpcUrl);
 var payer = createRelayerX402Payer({
-  facilitatorBaseUrl: relayerBaseUrl,
+  relayerBaseUrl,
   signer,
   rpc,
   x402Fetch: await createSvmX402Fetch({ agentSecretKey, rpcUrl }),
@@ -2398,10 +2398,10 @@ var payer = createRelayerX402Payer({
 await runMcpPaymentServer({
   payer,
   signer,
-  facilitatorBaseUrl: relayerBaseUrl,
+  relayerBaseUrl,
   defaultMaxAmountRawUsdc,
   vaultFlows: new VaultFlowClient({
-    facilitatorBaseUrl: relayerBaseUrl,
+    relayerBaseUrl,
     signer,
     rpc
   })

package/dist/pay.js

@@ -998,7 +998,7 @@ var OnboardingError = class extends Error {
 };
 async function ensureWalletOnboarded(params) {
   const fetchImpl = params.fetchImpl ?? fetch;
-  const baseUrl = params.facilitatorBaseUrl.replace(/\/$/, "");
+  const baseUrl = params.relayerBaseUrl.replace(/\/$/, "");
   const post = async (step, path, body2) => {
     const url2 = `${baseUrl}${path}`;
     const serialized = JSON.stringify(body2);
@@ -1100,7 +1100,7 @@ var VaultFlowClient = class {
   pollTimeoutMs;
   pollIntervalMs;
   constructor(config) {
-    this.baseUrl = config.facilitatorBaseUrl.replace(/\/$/, "");
+    this.baseUrl = config.relayerBaseUrl.replace(/\/$/, "");
     this.signer = config.signer;
     this.fetchImpl = config.fetchImpl ?? fetch;
     this.lookupTablesFor = config.lookupTablesFor ?? ((serializedTransaction) => fetchLookupTablesForTransaction(config.rpc, serializedTransaction));
@@ -1313,7 +1313,7 @@ var RelayerYieldRealizer = class {
   vaultFlows;
   constructor(config) {
     this.vaultFlows = new VaultFlowClient({
-      facilitatorBaseUrl: config.facilitatorBaseUrl,
+      relayerBaseUrl: config.relayerBaseUrl,
       signer: config.signer,
       rpc: config.rpc,
       ...config.fetchImpl === void 0 ? {} : { fetchImpl: config.fetchImpl },
@@ -1868,7 +1868,7 @@ function pendingPaymentKey(input) {
 // ../../src/client/relayer-payer.ts
 function createRelayerX402Payer(config) {
   const realizer = new RelayerYieldRealizer({
-    facilitatorBaseUrl: config.facilitatorBaseUrl,
+    relayerBaseUrl: config.relayerBaseUrl,
     signer: config.signer,
     rpc: config.rpc
   });
@@ -2041,7 +2041,7 @@ var agentSecretKey = loadSecretKeyBytes({
 var signer = new LocalKeypairAgentWalletSigner(keyPairSigner);
 var rpc = createRpc(rpcUrl);
 var payer = createRelayerX402Payer({
-  facilitatorBaseUrl: relayerBaseUrl,
+  relayerBaseUrl,
   signer,
   rpc,
   x402Fetch: await createSvmX402Fetch({ agentSecretKey, rpcUrl }),
@@ -2052,7 +2052,7 @@ var method = process.env.SUBLY_PAY_METHOD;
 var body = process.env.SUBLY_PAY_BODY;
 console.error(`[pay] agent ${signer.walletAddress} -> ${url}`);
 try {
-  await ensureWalletOnboarded({ facilitatorBaseUrl: relayerBaseUrl, signer });
+  await ensureWalletOnboarded({ relayerBaseUrl, signer });
 } catch (error) {
   console.error(
     `[pay] onboarding skipped: ${error instanceof Error ? error.message : String(error)}`

package/dist/withdraw.js

@@ -1038,7 +1038,7 @@ var VaultFlowClient = class {
   pollTimeoutMs;
   pollIntervalMs;
   constructor(config) {
-    this.baseUrl = config.facilitatorBaseUrl.replace(/\/$/, "");
+    this.baseUrl = config.relayerBaseUrl.replace(/\/$/, "");
     this.signer = config.signer;
     this.fetchImpl = config.fetchImpl ?? fetch;
     this.lookupTablesFor = config.lookupTablesFor ?? ((serializedTransaction) => fetchLookupTablesForTransaction(config.rpc, serializedTransaction));
@@ -1296,7 +1296,7 @@ var rpc = createRpc(
   process.env.SOLANA_RPC_URL ?? "https://api.mainnet-beta.solana.com"
 );
 var vaultFlows = new VaultFlowClient({
-  facilitatorBaseUrl: relayerBaseUrl,
+  relayerBaseUrl,
   signer,
   rpc
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@subly_fi/pay",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Subly client: pay for ANY standard x402 (HTTP 402) paid API from Kamino vault yield — the seller needs no Subly integration. Ships an MCP server and a one-shot pay/deposit CLI; non-custodial (signs locally with your own key).",
   "license": "MIT",
   "type": "module",