@subly_fi/pay 0.7.2 → 0.7.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +12 -12
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -9,42 +9,42 @@ Version 0.7 is beta software and has not had an external security audit. Vault o
9
9
  You need **Node.js 24+**, a Solana agent wallet with mainnet USDC, a trusted relayer URL, and a mainnet RPC endpoint that supports transaction simulation with inner instructions. Your wallet can be a local keypair or a supported custody signer. The owner who approves spending controls can use a passkey or a separate Solana wallet.
10
10
 
11
11
  ```bash
12
- npx -y @subly_fi/pay@0.7.2 --help
12
+ npx -y @subly_fi/pay@0.7.3 --help
13
13
  export SUBLY_RELAYER_URL=https://your-relayer.example.com
14
14
  export SOLANA_RPC_URL=https://your-mainnet-rpc.example.com
15
15
  export SUBLY_DEMO_AGENT_KEYPAIR_PATH=/absolute/path/to/agent.json
16
- npx -y @subly_fi/pay@0.7.2 doctor
17
- npx -y @subly_fi/pay@0.7.2 vaults
16
+ npx -y @subly_fi/pay@0.7.3 doctor
17
+ npx -y @subly_fi/pay@0.7.3 vaults
18
18
  ```
19
19
 
20
20
  Use an existing dedicated agent wallet, or create one with `solana-keygen new -o agent.json`. Keep its recovery material private and restrict the file to its owner (`chmod 600 agent.json`). Fund its public address with **USDC on Solana mainnet**. Subly does not create or fund wallets. Vault fees require a funded relayer sponsor; the final API payment requires the seller's facilitator fee payer.
21
21
 
22
22
  1. Review the selected vault, its curator, fees and liquidity. For a catalogue supplied by your operator, install the reviewed file locally and set `SUBLY_VAULTS_FILE=/absolute/path/vaults.json`. `SUBLY_VAULT_ADDRESS` selects one listed vault for CLI commands. Never install transaction trust anchors merely because a remote response says to.
23
- 2. Create an owner setup link. This example pre-approves a **1.01 USDC** deposit; the selected vault's minimum can differ:
23
+ 2. Create an owner setup link. On the first owner registration, this example pre-approves a **1.01 USDC** deposit; the selected vault's minimum can differ:
24
24
 
25
25
  ```bash
26
- npx -y @subly_fi/pay@0.7.2 setup-link --initial-deposit 1010000
26
+ npx -y @subly_fi/pay@0.7.3 setup-link --initial-deposit 1010000
27
27
  ```
28
28
 
29
- Open the returned `setupUrl`, review the wallet, vault and limits, then approve with your passkey or wallet. Links expire in 10 minutes. Treat setup and approval links as private capabilities. The first person completing an initial setup becomes the owner for that wallet/vault.
29
+ Open the returned `setupUrl`, review the wallet, vault and limits, then approve with your passkey or wallet. Links expire in 10 minutes. Treat setup and approval links as private capabilities. The first person completing an initial setup becomes the owner for that wallet/vault. Replacing an existing mandate requires a separate deposit approval; follow the approval link returned by the deposit command.
30
30
  3. Check completion and deposit promptly; initial deposit approval lasts about 15 minutes:
31
31
 
32
32
  ```bash
33
- npx -y @subly_fi/pay@0.7.2 setup-status <sessionId>
34
- npx -y @subly_fi/pay@0.7.2 deposit 1010000
35
- npx -y @subly_fi/pay@0.7.2 budget
33
+ npx -y @subly_fi/pay@0.7.3 setup-status <sessionId>
34
+ npx -y @subly_fi/pay@0.7.3 deposit 1010000
35
+ npx -y @subly_fi/pay@0.7.3 budget
36
36
  ```
37
37
 
38
38
  4. Wait until **spendable yield** covers the price and vault fees. A new deposit does not immediately provide a payment budget. Then request a compatible API:
39
39
 
40
40
  ```bash
41
- npx -y @subly_fi/pay@0.7.2 fetch https://seller.example.com/paid-resource
41
+ npx -y @subly_fi/pay@0.7.3 fetch https://seller.example.com/paid-resource
42
42
  ```
43
43
 
44
44
  5. Withdraw funds back to the same agent wallet when needed:
45
45
 
46
46
  ```bash
47
- npx -y @subly_fi/pay@0.7.2 withdraw 1000000
47
+ npx -y @subly_fi/pay@0.7.3 withdraw 1000000
48
48
  ```
49
49
 
50
50
  All amounts are raw USDC integers: `1000000` = 1 USDC. `fetch` defaults to a **0.01 USDC cap**, configurable with `SUBLY_MCP_MAX_AMOUNT_RAW_USDC` or `fetch <URL> <capRawUSDC>`. The owner mandate may set stricter limits. `setup-link --help` lists policy options. A withdrawal can include principal and is subject to liquidity, fees and the owner's policy. A revoked mandate also blocks relayer withdrawals.
@@ -60,7 +60,7 @@ Add this to the MCP configuration of your editor or agent host. Replace all exam
60
60
  "mcpServers": {
61
61
  "subly": {
62
62
  "command": "npx",
63
- "args": ["-y", "@subly_fi/pay@0.7.2", "mcp"],
63
+ "args": ["-y", "@subly_fi/pay@0.7.3", "mcp"],
64
64
  "env": {
65
65
  "SUBLY_RELAYER_URL": "https://your-relayer.example.com",
66
66
  "SOLANA_RPC_URL": "https://your-mainnet-rpc.example.com",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@subly_fi/pay",
3
- "version": "0.7.2",
3
+ "version": "0.7.3",
4
4
  "description": "Subly client: pay compatible standard x402 Solana USDC exact APIs 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).",
5
5
  "keywords": [
6
6
  "x402",