gdex_connect
Connects a GDEX trading account without exposing secrets by using a local key file, creating a new wallet, or refreshing an accountRef; returns an accountRef for use with trading tools.
Instructions
Connect a GDEX trading account without putting any secret in the conversation. Signs in from a control-wallet key file on this machine (keyFile), or creates a new local wallet (create: true), or refreshes an existing accountRef. Returns an accountRef plus public addresses; pass accountRef to any trading tool instead of sessionPrivateKey/privateKey. Never ask the user to paste a private key or seed phrase.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "gdex_connect"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| create | No | Create and store a new local control wallet (it starts unfunded) | |
| keyFile | No | Path to a local JSON key file ({ privateKey } or { control: { privateKey } }) | |
| accountRef | No | Refresh the session of an already connected account | |
| inviteCode | No | Only with create: true, and only when the user explicitly chose to use someone's GDEX invite. Counts only for a brand-new account. |