@silkysquad/silk 1.0.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/CHANGELOG.md +43 -0
- package/LICENSE +21 -0
- package/README.md +94 -0
- package/SKILL.md +698 -0
- package/index.js +1 -0
- package/package.json +10 -0
- package/src/cli.ts +175 -0
- package/src/client.ts +49 -0
- package/src/commands/account.ts +210 -0
- package/src/commands/balance.ts +14 -0
- package/src/commands/cancel.ts +34 -0
- package/src/commands/chat.ts +14 -0
- package/src/commands/claim.ts +34 -0
- package/src/commands/config.ts +46 -0
- package/src/commands/contacts.ts +26 -0
- package/src/commands/init.ts +44 -0
- package/src/commands/pay.ts +41 -0
- package/src/commands/payments.ts +29 -0
- package/src/commands/wallet.ts +67 -0
- package/src/config.ts +101 -0
- package/src/contacts.ts +94 -0
- package/src/errors.ts +95 -0
- package/src/index.ts +11 -0
- package/src/output.ts +42 -0
- package/src/transfers.ts +49 -0
- package/src/validate.ts +80 -0
- package/tsconfig.json +19 -0
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
All notable changes to the Silkyway SDK will be documented in this file.
|
|
4
|
+
|
|
5
|
+
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
|
6
|
+
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
|
+
|
|
8
|
+
## [0.1.0] - 2026-02-12
|
|
9
|
+
|
|
10
|
+
### Added
|
|
11
|
+
|
|
12
|
+
- Initial release extracted from monorepo
|
|
13
|
+
- Escrow transfer support (`silk pay`, `silk claim`, `silk cancel`)
|
|
14
|
+
- On-chain account support with operator delegation and spending limits
|
|
15
|
+
- Multi-wallet management (`silk wallet create`, `silk wallet list`)
|
|
16
|
+
- Address book for contacts (`silk contacts add/remove/list/get`)
|
|
17
|
+
- Claim links for browser-based payment claiming
|
|
18
|
+
- Drift protocol integration for yield on account balances
|
|
19
|
+
- Multi-cluster support (mainnet-beta and devnet)
|
|
20
|
+
- Support chat integration (`silk chat`)
|
|
21
|
+
- DevNet faucet for testing (`silk wallet fund`)
|
|
22
|
+
- OpenClaw skill integration with ClawHub publishing
|
|
23
|
+
- Comprehensive CLI reference and API documentation
|
|
24
|
+
|
|
25
|
+
### Distribution
|
|
26
|
+
|
|
27
|
+
- Published to npm registry as `@silkyway/silk`
|
|
28
|
+
- Published to ClawHub as "silkyway" skill
|
|
29
|
+
- Dedicated repository at https://github.com/silkysquad/silk
|
|
30
|
+
|
|
31
|
+
### Requirements
|
|
32
|
+
|
|
33
|
+
- Node.js 18 or higher
|
|
34
|
+
- npm (comes with Node.js)
|
|
35
|
+
- Internet connection to Solana RPC and silkyway.ai API
|
|
36
|
+
|
|
37
|
+
### Security
|
|
38
|
+
|
|
39
|
+
- Non-custodial: private keys stored locally at `~/.config/silk/config.json`
|
|
40
|
+
- All authorization enforced on-chain by Solana programs
|
|
41
|
+
- Backend never sees private keys (build-sign-submit flow)
|
|
42
|
+
|
|
43
|
+
[0.1.0]: https://github.com/silkysquad/silk/releases/tag/v0.1.0
|
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Silkyway
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
ADDED
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
# Silkyway SDK
|
|
2
|
+
|
|
3
|
+
Agent payments on Solana. Send and receive USDC with cancellable escrow transfers and policy-controlled accounts.
|
|
4
|
+
|
|
5
|
+
## Installation
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npm install -g @silkyway/silk
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
Requires Node.js 18+.
|
|
12
|
+
|
|
13
|
+
## Quick Start
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
# Initialize wallet
|
|
17
|
+
silk init
|
|
18
|
+
|
|
19
|
+
# Check balance
|
|
20
|
+
silk balance
|
|
21
|
+
|
|
22
|
+
# Send payment
|
|
23
|
+
silk pay <recipient> <amount>
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
## Documentation
|
|
27
|
+
|
|
28
|
+
- **[Full skill documentation](./SKILL.md)** - Complete CLI reference and API docs
|
|
29
|
+
- **[Website](https://silkyway.ai)** - Homepage and web app
|
|
30
|
+
- **[GitHub](https://github.com/silkysquad/silk)** - Source code and issues
|
|
31
|
+
|
|
32
|
+
## Features
|
|
33
|
+
|
|
34
|
+
- **Escrow Transfers** - Send USDC with claim/cancel options
|
|
35
|
+
- **On-Chain Accounts** - Policy-enforced spending limits for agent operators
|
|
36
|
+
- **Multi-Wallet** - Manage multiple Solana wallets
|
|
37
|
+
- **Address Book** - Save contacts for easy payments
|
|
38
|
+
- **Claim Links** - Share browser-based claim URLs
|
|
39
|
+
- **Drift Integration** - Optional yield on account balances
|
|
40
|
+
- **Multi-Cluster** - Support for mainnet and devnet
|
|
41
|
+
|
|
42
|
+
## Examples
|
|
43
|
+
|
|
44
|
+
### Send a Payment
|
|
45
|
+
|
|
46
|
+
```bash
|
|
47
|
+
# Send 10 USDC to an address
|
|
48
|
+
silk pay 7xKXz9BpR3mFVDg2Thh3AG6sFRPqNrDJ4bHUkR8Y7vNx 10 --memo "Payment for code review"
|
|
49
|
+
|
|
50
|
+
# Send to a contact
|
|
51
|
+
silk contacts add alice 7xKXz9BpR3mFVDg2Thh3AG6sFRPqNrDJ4bHUkR8Y7vNx
|
|
52
|
+
silk pay alice 10
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
### Claim a Payment
|
|
56
|
+
|
|
57
|
+
```bash
|
|
58
|
+
# List incoming payments
|
|
59
|
+
silk payments list
|
|
60
|
+
|
|
61
|
+
# Claim a transfer
|
|
62
|
+
silk claim <transfer-pda>
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
### Use an Account
|
|
66
|
+
|
|
67
|
+
```bash
|
|
68
|
+
# Sync your operator account (set up by human via web UI)
|
|
69
|
+
silk account sync
|
|
70
|
+
|
|
71
|
+
# Check account status and spending limit
|
|
72
|
+
silk account status
|
|
73
|
+
|
|
74
|
+
# Send from account (subject to per-tx limit)
|
|
75
|
+
silk account send <recipient> <amount>
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
## Security
|
|
79
|
+
|
|
80
|
+
Silkyway is non-custodial. Your private keys:
|
|
81
|
+
- Are generated locally on your machine
|
|
82
|
+
- Are stored at `~/.config/silk/config.json`
|
|
83
|
+
- Never leave your machine
|
|
84
|
+
- Are never transmitted to any server
|
|
85
|
+
|
|
86
|
+
All transactions are signed locally. The backend only builds unsigned transactions and relays signed transactions to Solana.
|
|
87
|
+
|
|
88
|
+
## Contributing
|
|
89
|
+
|
|
90
|
+
Issues and pull requests are welcome at https://github.com/silkysquad/silk
|
|
91
|
+
|
|
92
|
+
## License
|
|
93
|
+
|
|
94
|
+
MIT
|