torchsdk 2.0.0 → 3.2.0
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/dist/ephemeral.d.ts +33 -0
- package/dist/ephemeral.d.ts.map +1 -0
- package/dist/ephemeral.js +39 -0
- package/dist/ephemeral.js.map +1 -0
- package/dist/index.d.ts +4 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +7 -1
- package/dist/index.js.map +1 -1
- package/dist/program.d.ts +2 -1
- package/dist/program.d.ts.map +1 -1
- package/dist/program.js.map +1 -1
- package/dist/tokens.d.ts.map +1 -1
- package/dist/tokens.js +2 -0
- package/dist/tokens.js.map +1 -1
- package/dist/torch_market.json +1262 -525
- package/dist/transactions.d.ts +34 -1
- package/dist/transactions.d.ts.map +1 -1
- package/dist/transactions.js +280 -11
- package/dist/transactions.js.map +1 -1
- package/dist/types.d.ts +37 -0
- package/dist/types.d.ts.map +1 -1
- package/package.json +2 -2
- package/readme.md +47 -28
package/dist/types.d.ts
CHANGED
|
@@ -102,6 +102,7 @@ export interface VaultInfo {
|
|
|
102
102
|
total_deposited: number;
|
|
103
103
|
total_withdrawn: number;
|
|
104
104
|
total_spent: number;
|
|
105
|
+
total_received: number;
|
|
105
106
|
linked_wallets: number;
|
|
106
107
|
created_at: number;
|
|
107
108
|
}
|
|
@@ -139,6 +140,13 @@ export interface TransferAuthorityParams {
|
|
|
139
140
|
vault_creator: string;
|
|
140
141
|
new_authority: string;
|
|
141
142
|
}
|
|
143
|
+
export interface WithdrawTokensParams {
|
|
144
|
+
authority: string;
|
|
145
|
+
vault_creator: string;
|
|
146
|
+
mint: string;
|
|
147
|
+
destination: string;
|
|
148
|
+
amount: number;
|
|
149
|
+
}
|
|
142
150
|
export interface BuyParams {
|
|
143
151
|
mint: string;
|
|
144
152
|
buyer: string;
|
|
@@ -163,6 +171,8 @@ export interface SellParams {
|
|
|
163
171
|
amount_tokens: number;
|
|
164
172
|
slippage_bps?: number;
|
|
165
173
|
message?: string;
|
|
174
|
+
/** Vault creator pubkey. SOL goes to vault, tokens sold from vault ATA. */
|
|
175
|
+
vault?: string;
|
|
166
176
|
}
|
|
167
177
|
export interface CreateTokenParams {
|
|
168
178
|
creator: string;
|
|
@@ -173,6 +183,22 @@ export interface CreateTokenParams {
|
|
|
173
183
|
export interface StarParams {
|
|
174
184
|
mint: string;
|
|
175
185
|
user: string;
|
|
186
|
+
/** Vault creator pubkey. Vault pays the 0.05 SOL star cost. */
|
|
187
|
+
vault?: string;
|
|
188
|
+
}
|
|
189
|
+
export interface VaultSwapParams {
|
|
190
|
+
/** Token mint address */
|
|
191
|
+
mint: string;
|
|
192
|
+
/** Controller wallet (linked to vault, signs the tx) */
|
|
193
|
+
signer: string;
|
|
194
|
+
/** Vault creator pubkey (for PDA derivation) */
|
|
195
|
+
vault_creator: string;
|
|
196
|
+
/** Input amount (lamports for buy, token base units for sell) */
|
|
197
|
+
amount_in: number;
|
|
198
|
+
/** Minimum output for slippage protection */
|
|
199
|
+
minimum_amount_out: number;
|
|
200
|
+
/** true = SOL→Token (buy), false = Token→SOL (sell) */
|
|
201
|
+
is_buy: boolean;
|
|
176
202
|
}
|
|
177
203
|
export interface TransactionResult {
|
|
178
204
|
transaction: Transaction;
|
|
@@ -187,16 +213,27 @@ export interface BorrowParams {
|
|
|
187
213
|
borrower: string;
|
|
188
214
|
collateral_amount: number;
|
|
189
215
|
sol_to_borrow: number;
|
|
216
|
+
/** Vault creator pubkey. Collateral from vault ATA, SOL to vault. */
|
|
217
|
+
vault?: string;
|
|
190
218
|
}
|
|
191
219
|
export interface RepayParams {
|
|
192
220
|
mint: string;
|
|
193
221
|
borrower: string;
|
|
194
222
|
sol_amount: number;
|
|
223
|
+
/** Vault creator pubkey. SOL repaid from vault, collateral returns to vault ATA. */
|
|
224
|
+
vault?: string;
|
|
195
225
|
}
|
|
196
226
|
export interface LiquidateParams {
|
|
197
227
|
mint: string;
|
|
198
228
|
liquidator: string;
|
|
199
229
|
borrower: string;
|
|
230
|
+
/** Vault creator pubkey. SOL paid from vault, collateral received to vault ATA. */
|
|
231
|
+
vault?: string;
|
|
232
|
+
}
|
|
233
|
+
export interface ClaimProtocolRewardsParams {
|
|
234
|
+
user: string;
|
|
235
|
+
/** Vault creator pubkey. Claimed SOL goes to vault instead of user. */
|
|
236
|
+
vault?: string;
|
|
200
237
|
}
|
|
201
238
|
export interface LendingInfo {
|
|
202
239
|
interest_rate_bps: number;
|
package/dist/types.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
package/readme.md
CHANGED
|
@@ -12,28 +12,38 @@ for in depth sdk design, refer to [design.md](./design.md).
|
|
|
12
12
|
|
|
13
13
|
for sdk audit, refer to [audit.md](./audit.md).
|
|
14
14
|
|
|
15
|
-
##
|
|
15
|
+
## Versioning
|
|
16
16
|
|
|
17
|
-
|
|
17
|
+
SDK version tracks the on-chain program IDL version. Starting from v3.2.0, both ship the same version number.
|
|
18
18
|
|
|
19
|
-
|
|
19
|
+
## What's New in v3.2.0
|
|
20
|
+
|
|
21
|
+
**Full Custody Vault + DEX Trading** — the vault now holds all assets (SOL and tokens). All operations route through the vault. The agent wallet is a disposable controller that holds nothing of value.
|
|
20
22
|
|
|
21
23
|
```
|
|
22
24
|
User (hardware wallet)
|
|
23
|
-
├── createVault()
|
|
24
|
-
├── depositVault(5 SOL)
|
|
25
|
-
├── linkWallet(agent)
|
|
25
|
+
├── createVault() → vault created, user auto-linked
|
|
26
|
+
├── depositVault(5 SOL) → vault funded
|
|
27
|
+
├── linkWallet(agent) → agent authorized as controller
|
|
26
28
|
│
|
|
27
|
-
Agent (
|
|
28
|
-
├── buy(vault=user)
|
|
29
|
-
├── sell()
|
|
29
|
+
Agent (disposable wallet, ~0.01 SOL for gas)
|
|
30
|
+
├── buy(vault=user) → vault SOL pays, tokens to vault ATA
|
|
31
|
+
├── sell(vault=user) → vault tokens sold, SOL returns to vault
|
|
32
|
+
├── vaultSwap(buy) → vault SOL → Raydium → tokens to vault ATA
|
|
33
|
+
├── vaultSwap(sell) → vault tokens → Raydium → SOL to vault
|
|
34
|
+
├── borrow(vault=user) → vault tokens locked, SOL to vault
|
|
35
|
+
├── repay(vault=user) → vault SOL repays, tokens returned to vault
|
|
36
|
+
├── liquidate(vault=user) → vault SOL pays, collateral to vault ATA
|
|
37
|
+
├── claimProtocolRewards(vault)→ protocol rewards SOL to vault
|
|
38
|
+
├── star(vault=user) → vault SOL pays star fee
|
|
30
39
|
│
|
|
31
40
|
User
|
|
32
|
-
├── withdrawVault()
|
|
33
|
-
|
|
41
|
+
├── withdrawVault() → pull SOL (authority only)
|
|
42
|
+
├── withdrawTokens(mint) → pull tokens (authority only)
|
|
43
|
+
└── unlinkWallet(agent) → revoke agent access instantly
|
|
34
44
|
```
|
|
35
45
|
|
|
36
|
-
Multiple wallets can share one vault. Deposit from a hardware wallet, trade from a hot wallet and an agent — all backed by the same SOL pool.
|
|
46
|
+
Multiple wallets can share one vault. Deposit from a hardware wallet, trade from a hot wallet and an agent — all backed by the same SOL pool. All value stays in the vault.
|
|
37
47
|
|
|
38
48
|
## API Reference
|
|
39
49
|
|
|
@@ -71,11 +81,12 @@ All builders return `{ transaction: Transaction, message: string }`. You sign an
|
|
|
71
81
|
|
|
72
82
|
| Function | Description |
|
|
73
83
|
|----------|-------------|
|
|
74
|
-
| `buildBuyTransaction(connection, params)` | Buy tokens (vault-funded
|
|
84
|
+
| `buildBuyTransaction(connection, params)` | Buy tokens on bonding curve (vault-funded) |
|
|
75
85
|
| `buildDirectBuyTransaction(connection, params)` | Buy tokens (buyer pays directly, no vault) |
|
|
76
|
-
| `buildSellTransaction(connection, params)` | Sell tokens back to the bonding curve |
|
|
86
|
+
| `buildSellTransaction(connection, params)` | Sell tokens back to the bonding curve (vault-routed) |
|
|
87
|
+
| `buildVaultSwapTransaction(connection, params)` | Buy/sell migrated tokens on Raydium DEX (vault-routed) |
|
|
77
88
|
| `buildCreateTokenTransaction(connection, params)` | Launch a new token |
|
|
78
|
-
| `buildStarTransaction(connection, params)` | Star a token (0.05 SOL) |
|
|
89
|
+
| `buildStarTransaction(connection, params)` | Star a token (0.05 SOL, vault-routed) |
|
|
79
90
|
|
|
80
91
|
#### Vault Management
|
|
81
92
|
|
|
@@ -84,6 +95,7 @@ All builders return `{ transaction: Transaction, message: string }`. You sign an
|
|
|
84
95
|
| `buildCreateVaultTransaction` | creator | Create vault + auto-link creator |
|
|
85
96
|
| `buildDepositVaultTransaction` | depositor | Deposit SOL (permissionless) |
|
|
86
97
|
| `buildWithdrawVaultTransaction` | authority | Withdraw SOL |
|
|
98
|
+
| `buildWithdrawTokensTransaction` | authority | Withdraw tokens from vault ATA |
|
|
87
99
|
| `buildLinkWalletTransaction` | authority | Link a wallet to the vault |
|
|
88
100
|
| `buildUnlinkWalletTransaction` | authority | Unlink a wallet |
|
|
89
101
|
| `buildTransferAuthorityTransaction` | authority | Transfer admin control |
|
|
@@ -92,9 +104,10 @@ All builders return `{ transaction: Transaction, message: string }`. You sign an
|
|
|
92
104
|
|
|
93
105
|
| Function | Description |
|
|
94
106
|
|----------|-------------|
|
|
95
|
-
| `buildBorrowTransaction(connection, params)` | Borrow SOL against token collateral |
|
|
96
|
-
| `buildRepayTransaction(connection, params)` | Repay SOL debt |
|
|
97
|
-
| `buildLiquidateTransaction(connection, params)` | Liquidate underwater position |
|
|
107
|
+
| `buildBorrowTransaction(connection, params)` | Borrow SOL against token collateral (vault-routed) |
|
|
108
|
+
| `buildRepayTransaction(connection, params)` | Repay SOL debt (vault-routed) |
|
|
109
|
+
| `buildLiquidateTransaction(connection, params)` | Liquidate underwater position (vault-routed) |
|
|
110
|
+
| `buildClaimProtocolRewardsTransaction(connection, params)` | Claim protocol trading rewards (vault-routed) |
|
|
98
111
|
|
|
99
112
|
### SAID Protocol
|
|
100
113
|
|
|
@@ -236,25 +249,31 @@ const { transaction } = await buildDirectBuyTransaction(connection, {
|
|
|
236
249
|
{ authority: string, vault_creator: string, wallet_to_unlink: string } // unlink
|
|
237
250
|
{ authority: string, vault_creator: string, new_authority: string } // transfer
|
|
238
251
|
|
|
239
|
-
//
|
|
240
|
-
{ mint: string,
|
|
241
|
-
|
|
242
|
-
|
|
252
|
+
// Vault Swap (DEX trading for migrated tokens)
|
|
253
|
+
{ mint: string, signer: string, vault_creator: string, amount_in: number, minimum_amount_out: number, is_buy: boolean }
|
|
254
|
+
|
|
255
|
+
// Lending (all support optional vault?: string for vault routing)
|
|
256
|
+
{ mint: string, borrower: string, collateral_amount: number, sol_to_borrow: number, vault?: string }
|
|
257
|
+
{ mint: string, borrower: string, sol_amount: number, vault?: string }
|
|
258
|
+
{ mint: string, liquidator: string, borrower: string, vault?: string }
|
|
259
|
+
|
|
260
|
+
// Rewards (optional vault routing)
|
|
261
|
+
{ user: string, vault?: string } // claim protocol rewards
|
|
243
262
|
```
|
|
244
263
|
|
|
245
264
|
## Vault Safety Model
|
|
246
265
|
|
|
247
|
-
The Torch Vault provides protocol-level
|
|
266
|
+
The Torch Vault provides protocol-level full custody for AI agent interaction:
|
|
248
267
|
|
|
249
268
|
| Property | Guarantee |
|
|
250
269
|
|----------|-----------|
|
|
251
|
-
| **
|
|
252
|
-
| **
|
|
270
|
+
| **Full custody** | Vault holds all SOL and all tokens. Controller wallet holds nothing. |
|
|
271
|
+
| **Closed loop** | All operations return value to the vault. No leakage to controller. |
|
|
253
272
|
| **Authority separation** | Creator (immutable PDA seed) vs Authority (transferable admin). Agent wallets get *usage* rights, not ownership. |
|
|
254
273
|
| **One link per wallet** | A wallet can only belong to one vault. PDA uniqueness enforces this. |
|
|
255
274
|
| **Permissionless deposits** | Anyone can top up any vault. Hardware wallet deposits, agent spends. |
|
|
256
275
|
| **Instant revocation** | Authority can unlink a wallet at any time. |
|
|
257
|
-
| **
|
|
276
|
+
| **Authority-only withdrawals** | Only the vault authority can withdraw SOL or tokens. Controllers cannot extract value. |
|
|
258
277
|
|
|
259
278
|
## Running the E2E Test
|
|
260
279
|
|
|
@@ -268,9 +287,9 @@ surfpool start --network mainnet --no-tui
|
|
|
268
287
|
npx tsx tests/test_e2e.ts
|
|
269
288
|
```
|
|
270
289
|
|
|
271
|
-
Expected output: `RESULTS:
|
|
290
|
+
Expected output: `RESULTS: 23 passed, 0 failed`
|
|
272
291
|
|
|
273
|
-
Test coverage: create token, vault lifecycle (create/deposit/query/withdraw), buy (direct + vault), link/unlink wallet, sell, star, messages, confirm, full bonding to 200 SOL, Raydium migration, borrow, repay.
|
|
292
|
+
Test coverage: create token, vault lifecycle (create/deposit/query/withdraw/withdraw tokens), buy (direct + vault), link/unlink wallet, sell, star, messages, confirm, full bonding to 200 SOL, Raydium migration, borrow, repay, vault swap (buy + sell on Raydium DEX), vault-routed liquidation, protocol reward claims.
|
|
274
293
|
|
|
275
294
|
## License
|
|
276
295
|
|