CLI Commands
All commands support --json for machine-readable JSON output.
status
Show vault status, on-chain metrics, and agent info.
7n7d status
7n7d status --json
Output:
- Network name
- Vault status
- Share Price (USDC, formatted from on-chain data)
- TVL (USDC, formatted from on-chain data)
- Agent status
- Number of open positions
positions
List open trading positions.
7n7d positions
7n7d positions --json
Output: Table of current positions with all available fields.
balance
Show vault shares, token balances, staked amount, and pending rewards for an address.
7n7d balance [address]
7n7d balance 0x1234...abcd --json
| Argument | Required | Description |
|---|---|---|
[address] | No | Ethereum address to query (defaults to wallet) |
Output:
- Vault share balance
- 7N7D token balance
- Staked 7N7D balance
- Pending USDC rewards
Requires on-chain RPC access. Configure rpcUrl or use a default network.
deposit
Deposit USDC into the trading vault. Automatically approves USDC spending.
7n7d deposit <amount>
7n7d deposit 1000
| Argument | Required | Description |
|---|---|---|
<amount> | Yes | USDC amount in human-readable units |
Requires: SEVEN_N_SEVEN_D_PRIVATE_KEY (env var or config file).
Output: Transaction hash and explorer link.
withdraw
Request withdrawal of vault shares. Subject to a 7-day withdrawal lock.
7n7d withdraw <shares>
7n7d withdraw 100
| Argument | Required | Description |
|---|---|---|
<shares> | Yes | Number of vault shares to withdraw |
Requires: SEVEN_N_SEVEN_D_PRIVATE_KEY
Output: Transaction hash and explorer link.
stake
Stake 7N7D tokens to earn USDC trading profit rewards. Automatically approves token spending.
7n7d stake <amount>
7n7d stake 5000
| Argument | Required | Description |
|---|---|---|
<amount> | Yes | 7N7D token amount to stake |
Requires: SEVEN_N_SEVEN_D_PRIVATE_KEY
Output: Transaction hash and explorer link.
unstake
Unstake 7N7D tokens.
7n7d unstake <amount>
7n7d unstake 5000
| Argument | Required | Description |
|---|---|---|
<amount> | Yes | 7N7D token amount to unstake |
Requires: SEVEN_N_SEVEN_D_PRIVATE_KEY
Output: Transaction hash and explorer link.
rewards
Show pending USDC staking rewards for an address.
7n7d rewards [address]
7n7d rewards 0x1234...abcd --json
| Argument | Required | Description |
|---|---|---|
[address] | No | Ethereum address to query (defaults to wallet) |
Output: Pending USDC reward amount.
chat
Send a message to the 7N7D AI trading agent.
7n7d chat "<message>"
7n7d chat "What is the current market outlook?" --json
| Argument | Required | Description |
|---|---|---|
<message> | Yes | Message to the agent |
Output: Agent response text and detected intent.
delegate-deposit
Build an ERC-7710 delegation for trustless vault deposits. This creates an unsigned delegation structure that allows a specified agent address to deposit USDC into the vault on your behalf.
7n7d delegate-deposit <amount> <agent-address>
7n7d delegate-deposit 1000 0xAgent... --expiry 2027-01-01T00:00:00Z
7n7d delegate-deposit 500 0xAgent... --json
| Argument | Required | Description |
|---|---|---|
<amount> | Yes | Maximum USDC the agent may deposit |
<agent-address> | Yes | Ethereum address of the 7N7D agent (delegate) |
| Option | Description |
|---|---|
--expiry <date> | ISO 8601 expiry date (default: no expiry) |
--network <net> | testnet or mainnet (default: testnet) |
--json | Output as JSON |
Output: Delegation summary with agent address, max amount, vault, and expiry.
Phase 1 builds an unsigned delegation structure. Phase 2 will add EIP-712 wallet signing via a --sign flag.
Configuration Reference
See CLI Overview for environment variables and config file setup.
See Also
- SDK API Reference — Use the SDK programmatically
- Getting Started — SDK installation