Merge pull request #220 from Edwardchennnn/docs/contract-dd-buy-routing

docs(gmgn-contract-dd): append the gmgn-token-buy boundary
This commit is contained in:
GMGN.AI
2026-09-04 16:11:28 +08:00
committed by GitHub
+3 -1
View File
@@ -1,6 +1,6 @@
--- ---
name: gmgn-contract-dd name: gmgn-contract-dd
description: "Contract due-diligence score for one token address — contract safety, holder structure and price action combined into a single 0-100 composite, capped by GMGN's own rug label, where every deduction names the field it read and an absent field is never a passing check. Use when the user wants one verdict number rather than fields: 尽调, CA 尽调, 给这个币打个分, 这个币安全吗, 能不能买, 有没有貔貅, is this token safe, rug check, honeypot check, due-diligence score, score this contract, or pastes a bare token contract address. A bare address may equally be a wallet — Step 0 resolves which and hands wallets to gmgn-wallet-analysis. Prefer this over gmgn-token whenever the ask is a verdict rather than a field dump; the raw fields themselves — price, market cap, liquidity, holder and trader lists, the unscored security fields — are gmgn-token, chip structure is gmgn-holder-analysis, chart-pattern naming is gmgn-kline-pattern." description: "Contract due-diligence score for one token address — contract safety, holder structure and price action combined into a single 0-100 composite, capped by GMGN's own rug label, where every deduction names the field it read and an absent field is never a passing check. Use when the user wants one verdict number rather than fields: 尽调, CA 尽调, 给这个币打个分, 这个币安全吗, 能不能买, 有没有貔貅, is this token safe, rug check, honeypot check, due-diligence score, score this contract, or pastes a bare token contract address. A bare address may equally be a wallet — Step 0 resolves which and hands wallets to gmgn-wallet-analysis. Prefer this over gmgn-token whenever the ask is a verdict rather than a field dump; the raw fields themselves — price, market cap, liquidity, holder and trader lists, the unscored security fields — are gmgn-token, chip structure is gmgn-holder-analysis, chart-pattern naming is gmgn-kline-pattern. Buy intent narrows to this skill only when the ask is a bare address: the input is --address, and no name is ever resolved here. When the user names the token instead — 帮我买 200u 的 PENGU, XX 能不能买, 能不能冲, 我想梭, buy me $500 of BONK — or wants a position size, gmgn-token-buy owns it, because picking the one right contract out of the same-name copycats and sizing slippage and gas are both outside this skill's input. That skill calls this one for the safety verdict rather than replacing it, so a bare address with no name and no amount still scores here exactly as before."
argument-hint: "--chain <sol|bsc|base|eth|robinhood|arc|stable> --address <token_address>" argument-hint: "--chain <sol|bsc|base|eth|robinhood|arc|stable> --address <token_address>"
metadata: metadata:
cliHelp: "gmgn-cli token security --help" cliHelp: "gmgn-cli token security --help"
@@ -99,6 +99,8 @@ Four skills take a token address. They answer different questions and must not b
A bare address with no question attached is a verdict ask: score it here, then offer the raw fields afterwards. Step 0 resolves token vs wallet before any of that — a bare base58 address is equally a wallet, and `token info` returns the same empty block either way — so a wallet goes to `gmgn-wallet-analysis` for the dossier, or `gmgn-portfolio` when the raw holdings, P&L and activity are what is wanted. A bare address with no question attached is a verdict ask: score it here, then offer the raw fields afterwards. Step 0 resolves token vs wallet before any of that — a bare base58 address is equally a wallet, and `token info` returns the same empty block either way — so a wallet goes to `gmgn-wallet-analysis` for the dossier, or `gmgn-portfolio` when the raw holdings, P&L and activity are what is wanted.
That table covers the four skills whose input is an address. `gmgn-token-buy` sits outside it because its input is a **name**: 「能不能买」 in the row above means 这个地址能不能买 — a bare address, nothing to disambiguate and no amount to size. 「帮我买 200u 的 XX」, 「PENGU 能不能买」, 「能不能冲」 name a token instead, and that is `gmgn-token-buy`: it resolves the name to the one right contract among its copycats, then sizes the order. It calls this skill for the safety verdict, so nothing scored here moves — the two are sequential, not alternatives.
The holder section (0.35) and the price section (0.20) are deliberately coarse: they exist to move one verdict number, not to explain a chip structure or a chart. Those three skills read the same raw fields on different thresholds and different weights, so their numbers will not match this composite, and neither number is a correction of the other. Never substitute one of their scores for a section score here, and never place two of these numbers side by side without saying they measure different things. The holder section (0.35) and the price section (0.20) are deliberately coarse: they exist to move one verdict number, not to explain a chip structure or a chart. Those three skills read the same raw fields on different thresholds and different weights, so their numbers will not match this composite, and neither number is a correction of the other. Never substitute one of their scores for a section score here, and never place two of these numbers side by side without saying they measure different things.
## Step 0 — Does GMGN have a record for this address at all? ## Step 0 — Does GMGN have a record for this address at all?