Skills gmgn-swap
๐ฆ
gmgn-swap
Content revision r1 Critical โ๏ธ External commands๐ Network access๐ Filesystem access๐ Env variables
Execute GMGN Token Swaps and Strategy Orders
Manual token trading across wallets and chains requires careful parameter handling. This skill prepares GMGN CLI operations with validation, quotes, and confirmation checkpoints.
Supports: Claude Codex Code(CC)
Do not auto-install this skill.
The canonical policy requires operator review before any installation action.
Install with my Agent
Copy this request to your Agent. It includes the canonical Skill page and manifest.
Agent request
Review the Skillstore skill "gmgn-swap" from https://skillstore.io/skills/gmgnai-gmgn-swap.md and its manifest at https://skillstore.io/api/skills/gmgnai-gmgn-swap/manifest. Verify the artifact. Do not auto-install. Inspect the skill and report your findings, then wait for an operator or manual installation decision.Your Agent should still show its plan and request any confirmation required by the security policy.
Agent-readable resources
Use these links when an AI agent, crawler, or script needs clean context instead of reading the full page.
Test it
Using "gmgn-swap". Quote swapping 0.1 SOL to a specified token on Solana.
Expected outcome:
Quote prepared: estimated token output, minimum output, slippage, wallet, and fees. No transaction was submitted.
Using "gmgn-swap". Sell 50 percent of a token balance for USDC.
Expected outcome:
Confirmation required: verified chain and addresses, percentage amount, estimated USDC proceeds, slippage, and fees.
Using "gmgn-swap". Check the result of a submitted swap.
Expected outcome:
Swap confirmed: human-readable spent and received amounts, transaction link, and order identifier.
Security Audit
Criticalv1 โข 9/5/2026 Open versioned report
The skill intentionally executes irreversible trades through an external CLI and relies on API and wallet private keys stored in a hidden environment file. Most backtick findings are Markdown false positives, but credential solicitation, secret access, financial commands, network reconnaissance, and confirmation bypasses are confirmed. Publication should wait until credential collection and transaction approval controls are redesigned. Static review was capped at 400/430 representative findings; omitted static matches are unconfirmed, so automatic publishing stays disabled until manual review.
1
Files scanned
849
Lines analyzed
34
Review items
0
False positives ignored
Confirmed security concerns (13)
Critical
Trade-Authorized API Key Solicited in Chat and Command Arguments
The setup flow says the user should send the API key, then directs `gmgn-cli config --apply <KEY>`. This exposes a trade-authorized secret to conversation logs and process arguments.
Line 31 directly requests the API key from the user and embeds it in a command argument; lines 448 and 839 explicitly prohibit that handling.
High
Crypto seed/private key mention
is the only skill holding a private key, and every buy still ends here. It
The text states that this workflow holds or uses a wallet private key for authenticated trading. Compromise or misuse of that key can authorize irreversible financial actions.
High
Crypto seed/private key mention
- **Signed auth** โ `swap` and most `order` subcommands require both `GMGN_API_KEY` and `GMGN_PRIVAT
The text states that this workflow holds or uses a wallet private key for authenticated trading. Compromise or misuse of that key can authorize irreversible financial actions.
High
Crypto seed/private key mention
| `order strategy create` | Create a limit/strategy order (requires private key) |
The text states that this workflow holds or uses a wallet private key for authenticated trading. Compromise or misuse of that key can authorize irreversible financial actions.
High
Crypto seed/private key mention
| `order strategy list` | List strategy orders (requires private key) |
The text states that this workflow holds or uses a wallet private key for authenticated trading. Compromise or misuse of that key can authorize irreversible financial actions.
High
Crypto seed/private key mention
| `order strategy cancel` | Cancel a strategy order (requires private key) |
The text states that this workflow holds or uses a wallet private key for authenticated trading. Compromise or misuse of that key can authorize irreversible financial actions.
High
Crypto seed/private key mention
`GMGN_API_KEY` must be configured in `~/.config/gmgn/.env`. `GMGN_PRIVATE_KEY` is additionally requi
The text states that this workflow holds or uses a wallet private key for authenticated trading. Compromise or misuse of that key can authorize irreversible financial actions.
High
Crypto seed/private key mention
- `GMGN_PRIVATE_KEY` is used exclusively for **local message signing** โ the private key never leave
The text states that this workflow holds or uses a wallet private key for authenticated trading. Compromise or misuse of that key can authorize irreversible financial actions.
Show all 13 confirmed findings
High
Environment file access
`GMGN_API_KEY` must be configured in `~/.config/gmgn/.env`. `GMGN_PRIVATE_KEY` is additionally requi
The CLI is instructed to read GMGN API and private keys from a hidden .env file. Plaintext credential storage and automated access create a direct secret-exposure risk.
High
Environment file access
- Both `GMGN_API_KEY` and `GMGN_PRIVATE_KEY` are read from the `.env` file by the CLI at startup. Th
The CLI is instructed to read GMGN API and private keys from a hidden .env file. Plaintext credential storage and automated access create a direct secret-exposure risk.
High
Token Safety Checks Can Be Bypassed for Irreversible Purchases
The skill permits users to skip its limited token check and proceed with a contract address. This can enable copycat, honeypot, or rug-token purchases without independent verification.
The documented entry flow and explicit override both allow execution without the required pre-swap check, while the skill acknowledges its check is incomplete.
High
Persistent Automation Flag Removes Per-Trade Human Confirmation
A preconfigured environment flag combined with `--yes` bypasses the terminal confirmation. An agent can then submit irreversible trades without fresh human approval for each transaction.
The documentation explicitly defines a headless path that suppresses confirmation whenever the persistent environment flag and command option are present.
Low
Network reconnaissance
**โ ๏ธ IPv6 NOT SUPPORTED: If you get a `401` or `403` error and credentials look correct, check for I
The line instructs enumeration of local IPv6 interfaces and an external IP check. This is limited network reconnaissance for troubleshooting, but it still discloses network configuration.
Capability review items (34)
These are real local capabilities that may be expected for this skill, so they require review but are not counted as confirmed malicious behavior.
Critical
Ruby/shell backtick execution
**BEFORE RUNNING ANY COMMAND: Run `gmgn-cli config --check`. If exit code is 0, proceed normally. If
This instruction runs external configuration commands and places a user-supplied API key in a command argument. That can expose a trade-authorized credential through chat, process listings, or shell history.
High
Generic API/secret keys
Use the `gmgn-cli` tool to submit a token swap or query an existing order. `GMGN_API_KEY` is always
The line documents active use of GMGN credentials for authenticated CLI operations. These credentials can execute trades on linked wallets and therefore represent sensitive environment access.
High
Generic API/secret keys
- **Signed auth** โ `swap` and most `order` subcommands require both `GMGN_API_KEY` and `GMGN_PRIVAT
The line documents active use of GMGN credentials for authenticated CLI operations. These credentials can execute trades on linked wallets and therefore represent sensitive environment access.
High
Generic API/secret keys
`GMGN_API_KEY` must be configured in `~/.config/gmgn/.env`. `GMGN_PRIVATE_KEY` is additionally requi
The line documents active use of GMGN credentials for authenticated CLI operations. These credentials can execute trades on linked wallets and therefore represent sensitive environment access.
High
Generic API/secret keys
Before displaying the confirmation, run `order quote` to get the estimated output (requires signed a
The line documents active use of GMGN credentials for authenticated CLI operations. These credentials can execute trades on linked wallets and therefore represent sensitive environment access.
High
Generic API/secret keys
Submit a token swap across multiple wallets concurrently. Each wallet executes independently โ one w
The line documents active use of GMGN credentials for authenticated CLI operations. These credentials can execute trades on linked wallets and therefore represent sensitive environment access.
High
Generic API/secret keys
- Both `GMGN_API_KEY` and `GMGN_PRIVATE_KEY` are read from the `.env` file by the CLI at startup. Th
The line documents active use of GMGN credentials for authenticated CLI operations. These credentials can execute trades on linked wallets and therefore represent sensitive environment access.
High
Generic API/secret keys
- `GMGN_PRIVATE_KEY` is used exclusively for **local message signing** โ the private key never leave
The line documents active use of GMGN credentials for authenticated CLI operations. These credentials can execute trades on linked wallets and therefore represent sensitive environment access.
High
Generic API/secret keys
- `GMGN_API_KEY` is transmitted in the `X-APIKEY` request header to GMGN's servers over HTTPS.
The line documents active use of GMGN credentials for authenticated CLI operations. These credentials can execute trades on linked wallets and therefore represent sensitive environment access.
High
Generic API/secret keys
Get an estimated output amount before submitting a swap. Uses normal auth โ only `GMGN_API_KEY` requ
The line documents active use of GMGN credentials for authenticated CLI operations. These credentials can execute trades on linked wallets and therefore represent sensitive environment access.
High
Generic API/secret keys
- `order strategy create`, `order strategy list`, and `order strategy cancel` use signed auth (requi
The line documents active use of GMGN credentials for authenticated CLI operations. These credentials can execute trades on linked wallets and therefore represent sensitive environment access.
High
Generic API/secret keys
- **Credential sensitivity** โ `GMGN_API_KEY` and `GMGN_PRIVATE_KEY` can directly execute trades on
The line documents active use of GMGN credentials for authenticated CLI operations. These credentials can execute trades on linked wallets and therefore represent sensitive environment access.
High
Hidden file in home directory
`GMGN_API_KEY` must be configured in `~/.config/gmgn/.env`. `GMGN_PRIVATE_KEY` is additionally requi
The skill requires reading API and private keys from a hidden file under the user home directory. Access to that plaintext credential file is security-sensitive.
High
Ruby/shell backtick execution
Use the `gmgn-cli` tool to submit a token swap or query an existing order. `GMGN_API_KEY` is always
The line directs use of gmgn-cli to submit token swaps and query orders. The external command can initiate irreversible financial transactions.
High
Ruby/shell backtick execution
- Every `swap` and `order strategy create` command submits an on-chain transaction that moves real f
The text confirms that the named external commands submit on-chain transactions moving real funds. This is an intentional, high-impact command capability.
High
Ruby/shell backtick execution
```bash
This fenced shell block contains gmgn-cli swap commands that submit irreversible token trades. The external command examples are intended for execution by the agent.
High
Ruby/shell backtick execution
```bash
This fenced shell example invokes gmgn-cli swap with conditional sell orders. Execution can move funds and create follow-on financial actions.
High
Ruby/shell backtick execution
```bash
This fenced shell example invokes gmgn-cli swap with fixed-amount strategy conditions. Execution can move funds and create follow-on orders.
High
Ruby/shell backtick execution
Submit a token swap across multiple wallets concurrently. Each wallet executes independently โ one w
The section directs concurrent swaps across as many as 100 wallets. This external operation can move funds from multiple accounts in one request.
High
Ruby/shell backtick execution
```bash
This fenced shell block contains multi-swap commands that can execute token trades across multiple wallets. The examples are intended operational commands.
High
Ruby/shell backtick execution
```bash
This fenced shell block creates take-profit, stop-loss, and smart-trade orders. These commands authorize future financial transactions using the linked wallet.
High
Ruby/shell backtick execution
```bash
This fenced shell block invokes strategy cancellation. Canceling an active protective or limit order changes the wallet owner's financial exposure.
Medium
Hidden file access
`GMGN_API_KEY` must be configured in `~/.config/gmgn/.env`. `GMGN_PRIVATE_KEY` is additionally requi
The skill requires reading API and private keys from a hidden file under the user home directory. Access to that plaintext credential file is security-sensitive.
Medium
Ruby/shell backtick execution
**IMPORTANT: Always use `gmgn-cli` commands below. Do NOT use web search, WebFetch, curl, or visit g
The line explicitly directs the agent to use the external gmgn-cli program for all swap operations. The command execution is intentional and central to the skill.
Medium
Ruby/shell backtick execution
**โ ๏ธ IPv6 NOT SUPPORTED: If you get a `401` or `403` error and credentials look correct, check for I
The instruction executes local network-enumeration commands and sends a request to an external IP service. This is real external command execution, although its stated purpose is IPv6 troubleshooting.
Medium
Ruby/shell backtick execution
- **`order_id` / `status`** โ After submitting a swap, the response includes an `order_id`. Use `ord
The line instructs the agent to invoke order get for status polling. This is a real authenticated external command, although it is read-only.
Medium
Ruby/shell backtick execution
- `gmgn-cli` installed globally โ if missing, run: `npm install -g gmgn-cli`
The line instructs a global npm installation of gmgn-cli. This is real external command execution with package supply-chain and system-wide installation risk.
Medium
Ruby/shell backtick execution
Before displaying the confirmation, run `order quote` to get the estimated output (requires signed a
The line explicitly instructs the agent to run order quote before confirmation. This is a real authenticated external command, but the operation is described as read-only.
Medium
Ruby/shell backtick execution
```bash
This fenced shell block invokes gmgn-cli order quote. The external command performs an authenticated network request without submitting a transaction.
Medium
Ruby/shell backtick execution
```bash
This fenced shell block invokes the authenticated order quote command. It is real external command execution, though it does not submit a trade.
Medium
Ruby/shell backtick execution
```bash
This fenced shell block invokes the authenticated order get command. It queries order state and does not itself submit a transaction.
Medium
Ruby/shell backtick execution
```bash
This fenced shell block invokes gmgn-cli gas-price against remote services. The commands are read-only but require external process and network access.
Medium
Ruby/shell backtick execution
```bash
This fenced shell block invokes authenticated strategy-list commands. The operation is read-only but still executes an external CLI with wallet credentials.
Low
Hardcoded URL
**โ ๏ธ IPv6 NOT SUPPORTED: If you get a `401` or `403` error and credentials look correct, check for I
The troubleshooting flow sends a request to a fixed third-party IP service, revealing the user's public address. The endpoint is purposeful but creates an external network and privacy dependency.
Risk Factors
โ๏ธ External commands (50)
SKILL.md:19 SKILL.md:20 SKILL.md:31 SKILL.md:33 SKILL.md:37 SKILL.md:39 SKILL.md:43 SKILL.md:45 SKILL.md:47 SKILL.md:51 SKILL.md:53 SKILL.md:55 SKILL.md:57 SKILL.md:63 SKILL.md:70 SKILL.md:72 SKILL.md:73 SKILL.md:82 SKILL.md:83 SKILL.md:84 SKILL.md:85 SKILL.md:86 SKILL.md:87 SKILL.md:88 SKILL.md:89 SKILL.md:93 SKILL.md:97 SKILL.md:99 SKILL.md:103 SKILL.md:104 SKILL.md:105 SKILL.md:106 SKILL.md:110 SKILL.md:112 SKILL.md:116 SKILL.md:120 SKILL.md:121 SKILL.md:122 SKILL.md:123 SKILL.md:124 SKILL.md:125 SKILL.md:126 SKILL.md:127 SKILL.md:129 SKILL.md:131 SKILL.md:133 SKILL.md:134 SKILL.md:135 SKILL.md:136 SKILL.md:137
๐ Network access (7)
๐ Filesystem access (5)
๐ Env variables (11)
Detected Patterns
Network reconnaissance
Audited by: codex
Share & cite this report
Share the versioned assessment report, neutral badge, embed card, and citations. Skillstore reports evidence without deciding whether this Skill is safe.
Copy report link
https://skillstore.io/skills/gmgnai-gmgn-swap/audits/1?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_reportMarkdown badge
[](https://skillstore.io/skills/gmgnai-gmgn-swap?utm_source=security_passport_badge)HTML badge
<a href="https://skillstore.io/skills/gmgnai-gmgn-swap?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/gmgnai-gmgn-swap/security.svg" alt="Skillstore security assessment" loading="lazy"></a>Embed card
<iframe src="https://skillstore.io/embed/skills/gmgnai-gmgn-swap.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>Academic citations (APA ยท BibTeX ยท CFF)
APA citation
gmgnai. (2026). gmgn-swap security audit report (audit version 1) [Author version unspecified]. Skillstore. https://skillstore.io/skills/gmgnai-gmgn-swap/audits/1BibTeX citation
@techreport{gmgnai-gmgnai-gmgn-swap-2026,
author = {gmgnai},
title = {gmgn-swap security audit report (audit version 1)},
institution = {Skillstore},
year = {2026},
number = {1},
url = {https://skillstore.io/skills/gmgnai-gmgn-swap/audits/1},
note = {Author version unspecified}
}CITATION.cff
cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "gmgn-swap security audit report (audit version 1)"
version: "unspecified"
type: report
authors:
- name: "gmgnai"
date-released: "2026-09-05"
url: "https://skillstore.io/skills/gmgnai-gmgn-swap/audits/1"
identifiers:
- type: other
value: "skillstore:gmgnai-gmgn-swap:audit:1"
description: "Skillstore immutable audit report identifier"
Skillstore Score
Why this score Evidence Confidence: Low 55
Architecture
85
Maintainability
87
Content
65
Community
74
Spec Compliance
What You Can Build
Confirm a Single Swap
Prepare a quoted token swap, review resolved addresses and fees, then submit after explicit approval.
Manage Exit Strategies
Create and monitor take-profit, stop-loss, or trailing orders for an existing token position.
Coordinate Wallet Batches
Prepare consistent trades across several linked wallets while preserving per-wallet amounts and results.
Try These Prompts
Request a Read-Only Quote
Quote swapping [amount] [input token] to [output token] on [chain] from [wallet]. Do not submit a transaction.
Prepare a Confirmed Swap
Prepare a swap of [amount] [input token] for [output token] on [chain]. Validate addresses, run safety checks, and show confirmation first.
Create a Protected Exit
Prepare a [take-profit or stop-loss] order for [token] on [chain] at [trigger]. Show amount, slippage, fees, and expiry before submission.
Plan a Multi-Wallet Strategy
Prepare a multi-wallet swap on [chain] using these wallets and amounts: [details]. Add [conditions], validate every address, and require final confirmation.
Best Practices
- Verify contract addresses independently and complete token safety checks before every purchase.
- Review chain, wallet, smallest-unit conversion, slippage, fees, and expected output before confirming.
- Use small test amounts, anti-MEV protection where supported, and fresh approval for every transaction.
Avoid
- Do not send API keys or private keys through chat, command arguments, logs, or screenshots.
- Do not identify tokens by name alone or skip contract verification because a trade is urgent.
- Do not enable unattended trade submission or retry failed transactions without renewed confirmation.
Frequently Asked Questions
Does this skill move real funds?
Yes. Swap and strategy creation commands can authorize irreversible blockchain transactions after confirmation.
Which credentials are required?
An API key is required. Swap and most strategy operations also require the private key linked to the wallet.
Can it find a token from its name?
No. Provide and independently verify the token contract address before preparing a trade.
Which networks are supported?
The documentation covers Solana, BSC, Base, Ethereum, Robinhood, Arc, and Stable, with feature differences between networks.
Can it trade across multiple wallets?
Yes. Multi-swap supports up to 100 wallets that are already bound to the GMGN API key.
Can a completed swap be reversed?
No. Confirmed blockchain transactions are irreversible, so review every parameter and expected cost before approval.
Developer Details
Author
gmgnaiLicense
MIT
Skillstore revision
r1
Version notice
The author did not declare a version.
Repository
https://github.com/gmgnai/gmgn-skills/tree/aa4d29a9b7d1aaaac3d6acd72c13f17575605348/skills/gmgn-swapRef
e5464e662405de6361fdde6b984f9ea865635f64
Maintenance freshness
9/8/2026
Usage
0 downloads ยท 0 views
File structure
๐ SKILL.md