@oneshot-agent/sdk 0.19.1 → 0.19.2
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 +19 -0
- package/dist/index.js +1 -1
- package/dist/swap.d.ts.map +1 -1
- package/dist/swap.js +7 -0
- package/dist/swap.js.map +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -18,6 +18,25 @@ npx -y @oneshot-agent/mcp-server
|
|
|
18
18
|
|
|
19
19
|
See the [MCP Server documentation](https://docs.oneshotagent.com/sdk/mcp) for setup instructions.
|
|
20
20
|
|
|
21
|
+
### Teach your coding agent to use OneShot
|
|
22
|
+
|
|
23
|
+
Install the OneShot [Agent Skills](https://skills.sh) into Claude Code, Cursor, Codex, and
|
|
24
|
+
[70+ other agents](https://github.com/vercel-labs/skills#supported-agents) so they know how to
|
|
25
|
+
call the SDK and MCP tools:
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
# All OneShot skills
|
|
29
|
+
npx skills add oneshot-agent/agent-skills
|
|
30
|
+
|
|
31
|
+
# Or just what you need (e.g. setup + email)
|
|
32
|
+
npx skills add oneshot-agent/agent-skills --skill oneshot --skill oneshot-email
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
Skills available: `oneshot` (setup/auth), `oneshot-email`, `oneshot-messaging`,
|
|
36
|
+
`oneshot-research`, `oneshot-enrichment`, `oneshot-commerce`, `oneshot-browser`,
|
|
37
|
+
`oneshot-build`, `oneshot-compute`, `soul-markets`. Source:
|
|
38
|
+
[oneshot-agent/agent-skills](https://github.com/oneshot-agent/agent-skills).
|
|
39
|
+
|
|
21
40
|
## Quick Start
|
|
22
41
|
|
|
23
42
|
```typescript
|
package/dist/index.js
CHANGED
|
@@ -49,7 +49,7 @@ Object.defineProperty(exports, "getSwapQuote", { enumerable: true, get: function
|
|
|
49
49
|
Object.defineProperty(exports, "executeSwap", { enumerable: true, get: function () { return swap_1.executeSwap; } });
|
|
50
50
|
__exportStar(require("./errors"), exports);
|
|
51
51
|
// Keep in sync with package.json `version`. Guarded by version.test.ts.
|
|
52
|
-
const SDK_VERSION = '0.19.
|
|
52
|
+
const SDK_VERSION = '0.19.2';
|
|
53
53
|
// ============================================================================
|
|
54
54
|
// Environment Configuration
|
|
55
55
|
// ============================================================================
|
package/dist/swap.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"swap.d.ts","sourceRoot":"","sources":["../src/swap.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMxD,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,gCAAgC;AAChC,eAAO,MAAM,sBAAsB,EAAE,gBAKpC,CAAC;AAEF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAG9D;
|
|
1
|
+
{"version":3,"file":"swap.d.ts","sourceRoot":"","sources":["../src/swap.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMxD,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,gCAAgC;AAChC,eAAO,MAAM,sBAAsB,EAAE,gBAKpC,CAAC;AAEF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAG9D;AA6BD,MAAM,WAAW,SAAS;IACxB,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,CAAC,eAAe,EAChC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAa,GACtB,OAAO,CAAC,SAAS,CAAC,CAiCpB;AAMD,MAAM,WAAW,UAAU;IACzB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,WAAW,CAC/B,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE,MAAM,CAAC,eAAe,EAChC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAa,GACtB,OAAO,CAAC,UAAU,CAAC,CAwDrB"}
|
package/dist/swap.js
CHANGED
|
@@ -39,6 +39,11 @@ const SWAP_ROUTER_ABI = [
|
|
|
39
39
|
];
|
|
40
40
|
// WETH/USDC pool fee tier: 0.05% (500) is the deepest liquidity on Base
|
|
41
41
|
const POOL_FEE = 500;
|
|
42
|
+
function validateSlippage(slippage) {
|
|
43
|
+
if (!Number.isFinite(slippage) || slippage < 0) {
|
|
44
|
+
throw new Error('Slippage must be a nonnegative finite number');
|
|
45
|
+
}
|
|
46
|
+
}
|
|
42
47
|
/**
|
|
43
48
|
* Get a quote for swapping ETH → USDC via Uniswap V3.
|
|
44
49
|
*
|
|
@@ -48,6 +53,7 @@ const POOL_FEE = 500;
|
|
|
48
53
|
* @param slippage - Slippage tolerance (0.01 = 1%)
|
|
49
54
|
*/
|
|
50
55
|
async function getSwapQuote(provider, usdcAmount, chainId, slippage = 0.01) {
|
|
56
|
+
validateSlippage(slippage);
|
|
51
57
|
const addresses = getAddresses(chainId);
|
|
52
58
|
const amountOut = ethers_1.ethers.parseUnits(usdcAmount, 6); // USDC has 6 decimals
|
|
53
59
|
const quoter = new ethers_1.ethers.Contract(addresses.quoterV2, QUOTER_V2_ABI, provider);
|
|
@@ -89,6 +95,7 @@ async function getSwapQuote(provider, usdcAmount, chainId, slippage = 0.01) {
|
|
|
89
95
|
* @param slippage - Slippage tolerance (default 1%)
|
|
90
96
|
*/
|
|
91
97
|
async function executeSwap(walletProvider, provider, usdcAmount, chainId, slippage = 0.01) {
|
|
98
|
+
validateSlippage(slippage);
|
|
92
99
|
if (!walletProvider.sendTransaction) {
|
|
93
100
|
throw new Error('Wallet provider does not support sendTransaction — required for ETH→USDC swap');
|
|
94
101
|
}
|
package/dist/swap.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"swap.js","sourceRoot":"","sources":["../src/swap.ts"],"names":[],"mappings":";;;AA+BA,oCAGC;
|
|
1
|
+
{"version":3,"file":"swap.js","sourceRoot":"","sources":["../src/swap.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@oneshot-agent/sdk",
|
|
3
|
-
"version": "0.19.
|
|
3
|
+
"version": "0.19.2",
|
|
4
4
|
"description": "Autonomous Agent SDK for executing real-world commercial transactions with automatic x402 payments",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"module": "dist/index.js",
|
|
@@ -61,4 +61,4 @@
|
|
|
61
61
|
"bugs": {
|
|
62
62
|
"url": "https://github.com/oneshot-agent/sdk/issues"
|
|
63
63
|
}
|
|
64
|
-
}
|
|
64
|
+
}
|