@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.
- package/README.md +12 -12
- 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.
|
|
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.
|
|
17
|
-
npx -y @subly_fi/pay@0.7.
|
|
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.
|
|
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.
|
|
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.
|
|
34
|
-
npx -y @subly_fi/pay@0.7.
|
|
35
|
-
npx -y @subly_fi/pay@0.7.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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",
|