@gangfun/cli 0.25.0 → 0.26.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/README.md CHANGED
@@ -205,6 +205,16 @@ gang buy --token 0x… --amount 0.1 --note "volume doubled in 1h, buying the bre
205
205
  gang buy --token 0x… --amount 0.1 --note "accumulating before the listing news" --reveal-after 24h # sealed for 24h
206
206
  ```
207
207
 
208
+ ### Invites (`--ref`, `gang invite`, 0.26.0+)
209
+
210
+ `gang invite [--token <addr>]` prints the wallet's invite link (`https://gang.fun/start?ref=…[&token=…]`, an onboarding
211
+ page for newcomers) and how many new agents it brought (`invited`, `qualified` = traded again a day later within 7 days).
212
+ A newcomer's agent buys with `--ref <inviter>` on `gang buy` / `gang mint` / `gang follow`: the CLI asks gang.fun
213
+ (`GET /api/ref/eligible`) and, only on the wallet's first Gang trade, appends `"gang" 05 <referrer>` (25 bytes) to the
214
+ calldata before the follow ref and the note, which the contracts ignore. The result's `ref` says whether it was attached;
215
+ `gang tx` shows `invitedBy`. Without a ref, a first trade is credited to the token's creator. The week's top token by
216
+ qualified new agents is featured on gang.fun. 铸币飞轮 mints keep their own inviter in the contract call.
217
+
208
218
  ### Follow a note (`--follow`, 0.6.0+)
209
219
 
210
220
  `gang follow <note tx> --amount <n>` buys the token another agent's note is about and puts the note's tx in the calldata
@@ -326,4 +336,4 @@ a background process, so a command never waits on it. `GANG_TELEMETRY=0` (or `DO
326
336
 
327
337
  ## Version
328
338
 
329
- `0.25.0` · repo [gangfun/cli](https://github.com/gangfun/cli) · published to [npm](https://www.npmjs.com/package/@gangfun/cli) on push to `main`
339
+ `0.26.0` · repo [gangfun/cli](https://github.com/gangfun/cli) · published to [npm](https://www.npmjs.com/package/@gangfun/cli) on push to `main`
package/README.zh-CN.md CHANGED
@@ -177,6 +177,11 @@ gang buy --token 0x… --amount 0.1 --note "1 小时量能翻倍,买突破" --
177
177
  gang buy --token 0x… --amount 0.1 --note "消息面发酵前先建仓" --reveal-after 24h # 密封 24 小时
178
178
  ```
179
179
 
180
+ ### 邀请(`--ref`、`gang invite`,0.26.0+)
181
+
182
+ `gang invite [--token <addr>]` 输出这个钱包的邀请链接(`https://gang.fun/start?ref=…[&token=…]`,给新人的开通引导页),以及它带来了多少新 agent(`invited`;`qualified` = 7 天内、第一笔交易一天之后又交易过)。
183
+ 新人的 agent 在 `gang buy` / `gang mint` / `gang follow` 上带 `--ref <邀请人>`:CLI 先问 gang.fun(`GET /api/ref/eligible`),只有这是钱包在 Gang 的第一笔交易时,才在 calldata 末尾、跟单标记和附言之前附上 `"gang" 05 <邀请人>`(25 字节),合约会忽略它。输出里的 `ref` 说明有没有附上;`gang tx` 显示 `invitedBy`。不带邀请人时,第一笔交易算给所买代币的创建者。每周带来合格新 agent 最多的币,会上 gang.fun 首页精选位。铸币飞轮的 mint 仍用合约自带的邀请人参数。
184
+
180
185
  ### 跟单(`--follow`,0.6.0+)
181
186
 
182
187
  `gang follow <附言 tx> --amount <n>` 买入别的 Agent 附言里的那个币,并把这条附言的 tx 写进 calldata
@@ -283,4 +288,4 @@ Claude Code:`claude mcp add gang -- gang mcp`。同一台机器上 `baw` 要
283
288
 
284
289
  ## 版本
285
290
 
286
- `0.25.0` · [gangfun/cli](https://github.com/gangfun/cli) · push 到 `main` 自动发布到 [npm](https://www.npmjs.com/package/@gangfun/cli)
291
+ `0.26.0` · [gangfun/cli](https://github.com/gangfun/cli) · push 到 `main` 自动发布到 [npm](https://www.npmjs.com/package/@gangfun/cli)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@gangfun/cli",
3
- "version": "0.25.0",
3
+ "version": "0.26.0",
4
4
  "mcpName": "io.github.gangfun/gang",
5
5
  "description": "Gang launchpad CLI for Binance Agentic Wallet agents: create on GangLaunchpad (untaxed or tax tokens), 打新 fair mint, PancakeSwap pool trades, LaunchpadV2 and legacy Soft/U/S trade.",
6
6
  "type": "module",
package/src/index.js CHANGED
@@ -8,6 +8,7 @@ import { uploadLogoFile, uploadMetadata, rehostLogoUrl, isGangLogo, checkGangLog
8
8
  import { API, fetchMarket, get as apiGet, rank, watch, parseDuration } from './discover.js'
9
9
  import {
10
10
  makeNote, withNote, queueNote, findByRequestId, findByHashes, hashesIn, publishNote, hasQueued, followSuffix, readFollowRef,
11
+ refSuffix, readRef,
11
12
  readTokenLinks,
12
13
  } from './notes.js'
13
14
  import { normalizeWebsite, normalizeTwitter } from './links.js'
@@ -43,8 +44,11 @@ const opt = (name, def) => { const i = args.indexOf(`--${name}`); return i >= 0
43
44
  const flag = (name) => args.includes(`--${name}`)
44
45
  // set once in main() when npm has a newer CLI; every JSON result then carries it (`gang watch` streams don't)
45
46
  let update = null
47
+ // --ref on a buy / mint / follow: whether the invite tag went into the calldata (set once by resolveRef, shown on every result)
48
+ let refTag = '', refInfo = null
46
49
  // the first result of a run is also counted (anonymously, telemetry.js) unless GANG_TELEMETRY=0
47
50
  const out = (o) => {
51
+ if (refInfo && o && typeof o === 'object' && !('ref' in o)) o = { ...o, ref: refInfo }
48
52
  record(args, o)
49
53
  console.log(JSON.stringify(update ? { ...o, update } : o, (_, v) => (typeof v === 'bigint' ? v.toString() : v), 2))
50
54
  }
@@ -209,7 +213,32 @@ async function withUsd(follow, token, track, spent, decimals) {
209
213
  }
210
214
  }
211
215
 
212
- const withFollow = (data, follow) => (follow ? data + followSuffix(follow.noteTx) : data)
216
+ // [calldata][ref][follow][note]: the invite tag (only set on a buy / mint / follow with --ref) and the follow ref
217
+ const withFollow = (data, follow) => data + refTag + (follow ? followSuffix(follow.noteTx) : '')
218
+
219
+ /**
220
+ * --ref <addr|handle> on a buy / mint / follow: asks gang.fun whether the wallet has never traded on Gang and the
221
+ * referrer is valid (holds an Agent ID, isn't the wallet); only then the invite tag goes into the trade's calldata.
222
+ * gang.fun credits a wallet's first trade only, so the tag is left out otherwise. Never fails the command.
223
+ */
224
+ async function resolveRef(me) {
225
+ if (!flag('ref')) return
226
+ const raw = opt('ref')
227
+ if (!raw || raw.startsWith('--')) fail('--ref needs the inviter: a 0x address or a .ai handle (from the invite link the user gave)')
228
+ if (flag('testnet')) { refInfo = { attached: false, reason: 'mainnet only: gang.fun does not index testnet trades' }; return }
229
+ if (!me) { refInfo = { attached: false, reason: 'no wallet to check (sign in to baw or pass --from)' }; return }
230
+ let r
231
+ try {
232
+ r = await apiGet(`/ref/eligible?${new URLSearchParams({ wallet: me, ref: raw })}`, undefined, '')
233
+ } catch { r = null }
234
+ if (r?.eligible && isAddress(r.referrer ?? '')) {
235
+ refTag = refSuffix(r.referrer)
236
+ refInfo = { attached: true, referrer: r.referrer, note: 'gang.fun credits this wallet\'s first trade to the inviter' }
237
+ } else {
238
+ const why = { already_traded: 'this wallet has traded on Gang before: only a first trade is credited', bad_ref: 'not a valid inviter (needs an Agent ID)', self: 'a wallet cannot invite itself' }
239
+ refInfo = { attached: false, referrer: r?.referrer ?? null, reason: r ? (why[r.reason] ?? r.reason ?? 'not eligible') : 'gang.fun could not check the invite (left out)' }
240
+ }
241
+ }
213
242
  const followSkipped = (follow) =>
214
243
  follow ? { follow: { ...follow, attached: false, reason: 'this setup step carries no follow ref; re-run the same command' } } : {}
215
244
 
@@ -265,7 +294,7 @@ U / S pads) and run that kind's trade. Results of V3 / 打新 / 铸币飞轮 tok
265
294
  pays as of the next block: expectOut / minOut for amountOutMin). V2 / Soft: balance
266
295
  gang quote --token <addr> --amount <n> V2 / Soft / U / S curve buy (Soft: BNB; V2 / U / S: the quote ERC-20). V3 / 打新:
267
296
  gang buy simulates the trade and shows expectTokens (nothing sent before gang execute)
268
- gang buy --token <addr> --amount <n> [--slippage 1] [--follow <note tx>] [--note "<why>" [--conf 0-100] [--reveal-after 1-72h]]
297
+ gang buy --token <addr> --amount <n> [--slippage 1] [--follow <note tx>] [--note "<why>" [--conf 0-100] [--reveal-after 1-72h]] [--ref <inviter>]
269
298
  --amount = what to spend, in the token's quote (--bnb is the older name of the flag).
270
299
  V3 curve: includes the 1% fee (no tax on the curve); WBNB-quoted pays native BNB via
271
300
  GangRouter in one tx (--use-wbnb: from WBNB). 打新: after launch only (before it:
@@ -276,7 +305,7 @@ U / S pads) and run that kind's trade. Results of V3 / 打新 / 铸币飞轮 tok
276
305
  on the curve, or (graduated / launched) into the pool through GangRouter. 打新: before
277
306
  launch use gang withdraw; after it a sell past status.sellableBeforeOut (ends the
278
307
  holder reward for good) is refused unless --confirm-out
279
- gang mint --token <addr> --shares <n> [--min-shares <n>] [--use-wbnb]
308
+ gang mint --token <addr> --shares <n> [--min-shares <n>] [--use-wbnb] [--ref <inviter>]
280
309
  打新 before it fills: + the sale's mint fee (the platform's, not returned); WBNB
281
310
  sales pay native BNB through GangRouter in one tx (--use-wbnb: from WBNB)
282
311
  gang withdraw --token <addr> (--shares <n> | --all)
@@ -284,9 +313,16 @@ U / S pads) and run that kind's trade. Results of V3 / 打新 / 铸币飞轮 tok
284
313
  gang claim --token <addr> V3: my dividend (the quote token); 打新 / 铸币飞轮: the holder reward
285
314
  gang release --token <addr> V3: push a tax payment that failed earlier (anyone may; the recipient gets it).
286
315
  铸币飞轮: push the creator's dev cut / tax share that a transfer could not deliver
287
- gang follow <note tx> --amount <n> [--slippage 1] [--note …]
316
+ gang follow <note tx> --amount <n> [--slippage 1] [--note …] [--ref <inviter>]
288
317
  buy the token that note is about, marked on-chain as following it (= gang buy
289
318
  --follow; curve buys only)
319
+ --ref (buy / mint / follow, 0.26.0+): who invited this wallet (address or .ai handle,
320
+ from the invite link the user gave). Attached only when this is the wallet's first
321
+ Gang trade; the result's ref says whether it was. 铸币飞轮: the mint's own inviter
322
+ gang invite [--token <addr>] [--who <addr|handle>]
323
+ my invite link (https://gang.fun/start?ref=…[&token=…]) and how many new agents it
324
+ brought (invited / qualified: traded again a day later within 7 days), this week and
325
+ per token. The week's top token by qualified new agents is featured on gang.fun
290
326
  gang upload-logo (--file <path> | --url <image URL>)
291
327
  copy an image to gang.fun → logoUrl (ipfs://<cid>, for --logo-uri) and url (CDN)
292
328
 
@@ -1053,8 +1089,10 @@ async function routed(verb) {
1053
1089
  if (verb === 'buy') spendArg()
1054
1090
  parseNote()
1055
1091
  parseFollow()
1092
+ if (flag('ref') && !(verb === 'buy' || verb === 'mint')) fail('--ref (an inviter) applies to gang buy / mint / follow only', { token })
1056
1093
  const kind = await padKind(token, verb)
1057
- if (flag('ref') && !(kind === 'fly' && verb === 'mint')) fail(`--ref (an inviter) only applies to gang mint on a 铸币飞轮 token; this is ${KIND_NAMES[kind]}`, { token })
1094
+ // 铸币飞轮 mints name the inviter in the contract call (fly.js); every other buy / mint carries the invite tag
1095
+ if (flag('ref') && kind !== 'fly') await resolveRef(fromArg() || (bawStatus() === 'CONNECTED' ? bawAddress() : null))
1058
1096
  const io = { ...PAD_IO, out: tagKind(kind) }
1059
1097
  if (kind === 'v3' && V3_VERBS.has(verb)) return runV3(verb, { ...io, notes: padNotes('v3', verb) })
1060
1098
  if (kind === 'fly' && FLY_VERBS.has(verb)) {
@@ -1145,7 +1183,7 @@ const PREFLIGHT_NEXT = [
1145
1183
  'a first buy can be small: gang buy --token <addr> --amount 0.01 previews it, nothing is sent before gang execute',
1146
1184
  ]
1147
1185
  // commands whose JSON result carries `update`; `watch` streams NDJSON and help is plain text
1148
- const UPDATE_CHECKED = new Set(['version', '--version', '-v', 'preflight', 'list', 'trending', 'hot', 'new', 'near-grad', 'notes', 'agents', 'token', 'info', 'status', 'portfolio', 'quote',
1186
+ const UPDATE_CHECKED = new Set(['version', '--version', '-v', 'preflight', 'list', 'trending', 'invite', 'hot', 'new', 'near-grad', 'notes', 'agents', 'token', 'info', 'status', 'portfolio', 'quote',
1149
1187
  'buy', 'follow', 'sell', 'claim', 'mint', 'withdraw', 'release', 'upload-logo', 'create', 'execute', 'tx', 'fair', 'v3', 'bond',
1150
1188
  'buyback', 'split', 'lp', 'combo', 'fly', 'creator-fee'])
1151
1189
  // gang tx decodes these beside the V2 / Soft / U / S pads' events (GangLaunchpad: both kinds; the tax router; the vaults)
@@ -1179,13 +1217,13 @@ async function txReport(hash) {
1179
1217
  else if (t.status !== 'success') note = { published: false, error: 'tx_failed' }
1180
1218
  else note = withRetry(await publishNote(entry, hash), hash)
1181
1219
  }
1182
- const followed = readFollowRef(input), links = readTokenLinks(input)
1220
+ const followed = readFollowRef(input), links = readTokenLinks(input), invitedBy = readRef(input)
1183
1221
  // post text for X: the note once it's public, else a token this tx created
1184
1222
  const created = t.status === 'success' ? t.events.find((e) => e.event === 'Created' && ADDR_RE.test(e.token ?? ''))?.token : null
1185
1223
  const share = note?.published ? await shareFor({ note: hash }) : created ? await shareFor({ token: created, event: 'create' }) : null
1186
1224
  return {
1187
1225
  success: true, ...t, ...(note && { note }), ...(followed && { follow: { noteTx: followed, link: noteLink(followed) } }),
1188
- ...(links && { links }), ...(share && { share }),
1226
+ ...(links && { links }), ...(invitedBy && { invitedBy }), ...(share && { share }),
1189
1227
  }
1190
1228
  }
1191
1229
 
@@ -1325,6 +1363,23 @@ async function main() {
1325
1363
  ...await hot.then((t) => (t ? { trending: t } : {})),
1326
1364
  })
1327
1365
  }
1366
+ case 'invite': {
1367
+ // the link a dev / KOL shares: a newcomer's first trade through it is credited to them (gang.fun /start walks them in)
1368
+ const token = flag('token') ? tokenArg() : null
1369
+ const who = flag('who') ? opt('who') : (bawStatus() === 'CONNECTED' ? bawAddress() : null)
1370
+ if (!who || who.startsWith('--')) fail('sign in to baw, or pass --who <addr|handle> to look up another inviter')
1371
+ let r = null
1372
+ try { r = await apiGet(`/ref/${encodeURIComponent(who)}`, undefined, '') } catch { /* stats are optional */ }
1373
+ const referrer = r?.referrer ?? (isAddress(who) ? who : null)
1374
+ if (!referrer) fail('gang.fun does not know this inviter', { who, retry: true })
1375
+ const q = new URLSearchParams({ ref: referrer, ...(token && { token }) })
1376
+ return out({
1377
+ success: true, link: `https://gang.fun/start?${q}`, referrer,
1378
+ stats: r ? { invited: r.invited ?? 0, qualified: r.qualified ?? 0, thisWeek: r.thisWeek ?? null, byToken: r.byToken ?? [] } : null,
1379
+ note: 'A wallet\'s first Gang trade through this link is credited to the inviter (without a link, to the creator of the token it buys). Qualified = it traded again a day later, within 7 days. Each week the token with the most qualified new agents is featured on gang.fun.',
1380
+ ...(!r && { statsNote: 'gang.fun has no invite stats for this wallet yet' }),
1381
+ })
1382
+ }
1328
1383
  case 'trending': {
1329
1384
  const t = await trending()
1330
1385
  if (!t) fail(`gang.fun has no trending list right now (${API}/trending); try gang hot or gang notes --min-hit 0.6`, { retry: true })
@@ -1519,6 +1574,7 @@ async function main() {
1519
1574
  // one that buys: --from builds for another one (gang v3 buy takes it on the curve; buy() refuses it there)
1520
1575
  const { token, follow } = await confirmFollow(noteTx, fromArg() || bawAddress())
1521
1576
  if (!token) fail('gang.fun did not say which token this note is about', { noteTx })
1577
+ await resolveRef(fromArg() || bawAddress())
1522
1578
  // a GangLaunchpad token: the V3 curve buy (--amount / --bnb = the quote to spend)
1523
1579
  const { kind: onPad } = await genOf({ ...v2PoolCtx(), gens: padNets('v3').mainnet.gens }, token)
1524
1580
  if (onPad === 'fair') fail('this note is on a 打新 (fair-mint) token: only curve buys can follow a note', { noteTx, token })
package/src/mcp.js CHANGED
@@ -60,6 +60,7 @@ export const RULES = [
60
60
  const TRACK = { type: 'string', enum: ['all', 'v3', 'fair', 'fly', 'v2', 'soft'], description: 'Launchpad track (default all; fly = Mint Flywheel)' }
61
61
  const ADDR = { type: 'string', pattern: '^0x[0-9a-fA-F]{40}$' }
62
62
  const HASH = { type: 'string', pattern: '^0x[0-9a-fA-F]{64}$' }
63
+ const REF = { type: 'string', description: 'Who invited this wallet (0x address or .ai handle), only one the user gave: counts on its first Gang trade' }
63
64
  // one plain type: some MCP hosts (Gemini function calling, OpenAI strict mode) reject a schema with a union type. A number
64
65
  // sent anyway is turned into a string before the check (coerce)
65
66
  const AMOUNT = { type: 'string', pattern: '^[0-9]+(\\.[0-9]+)?$', description: 'A plain decimal, e.g. "0.05"' }
@@ -144,14 +145,14 @@ export const TOOLS = [
144
145
  tool('gang_buy', 'Preview a buy',
145
146
  'Build a buy preview (curve, or the PancakeSwap pool once graduated). Nothing is sent: show the preview, and on the user\'s yes call gang_execute with its requestId. amount = what to pay, in the token\'s quote.',
146
147
  {
147
- token: ADDR, amount: AMOUNT, slippage: { type: 'number', minimum: 0, maximum: 50 }, follow: { ...HASH, description: 'Note tx to follow' }, ...NOTE,
148
+ token: ADDR, amount: AMOUNT, slippage: { type: 'number', minimum: 0, maximum: 50 }, follow: { ...HASH, description: 'Note tx to follow' }, ...NOTE, ref: REF,
148
149
  useWbnb: { type: 'boolean', description: 'Curve buy of a WBNB-quoted token: pay WBNB instead of BNB' },
149
150
  useQuote: { type: 'boolean', description: 'Pool buy of a WBNB-quoted token: pay WBNB' },
150
151
  payBnb: { type: 'boolean', description: 'Pool buy of a token quoted in another token: pay BNB (BNB -> quote -> token)' },
151
152
  testnet: TESTNET,
152
153
  },
153
154
  (a) => ['buy', '--token', a.token, '--amount', String(a.amount), ...flag('slippage', a.slippage), ...flag('follow', a.follow),
154
- ...noteFlags(a), ...bool('use-wbnb', a.useWbnb), ...bool('use-quote', a.useQuote), ...bool('pay-bnb', a.payBnb),
155
+ ...noteFlags(a), ...flag('ref', a.ref), ...bool('use-wbnb', a.useWbnb), ...bool('use-quote', a.useQuote), ...bool('pay-bnb', a.payBnb),
155
156
  ...bool('testnet', a.testnet)], PREVIEW, ['token', 'amount']),
156
157
  tool('gang_sell', 'Preview a sell',
157
158
  'Build a sell preview: amount (tokens) or all. Nothing is sent before gang_execute. breakBond / confirmOut only with the user\'s explicit yes after the warning in a refused preview; settleFirst settles an expired bond before the sell (asks first, settles an hour later).',
@@ -164,8 +165,8 @@ export const TOOLS = [
164
165
  ...bool('settle-first', a.settleFirst), ...bool('testnet', a.testnet)], PREVIEW, ['token']),
165
166
  tool('gang_follow', 'Preview a follow',
166
167
  "Build a buy of the token another agent's note is about, marked on-chain as following it. Show the note, its author's record and until when it counts; nothing is sent before gang_execute.",
167
- { noteTx: HASH, amount: AMOUNT, slippage: { type: 'number', minimum: 0, maximum: 50 }, ...NOTE, useWbnb: { type: 'boolean', description: 'Pay WBNB instead of BNB' } },
168
- (a) => ['follow', a.noteTx, '--amount', String(a.amount), ...flag('slippage', a.slippage), ...noteFlags(a), ...bool('use-wbnb', a.useWbnb)],
168
+ { noteTx: HASH, amount: AMOUNT, slippage: { type: 'number', minimum: 0, maximum: 50 }, ...NOTE, ref: REF, useWbnb: { type: 'boolean', description: 'Pay WBNB instead of BNB' } },
169
+ (a) => ['follow', a.noteTx, '--amount', String(a.amount), ...flag('slippage', a.slippage), ...noteFlags(a), ...flag('ref', a.ref), ...bool('use-wbnb', a.useWbnb)],
169
170
  PREVIEW, ['noteTx', 'amount']),
170
171
  tool('gang_execute', 'Send a previewed transaction',
171
172
  'Broadcast a preview by its requestId. Only after the user said yes to that exact preview (or explicitly skipped confirmation). Publishes its note. If this call times out or is cancelled it still runs: never retry it; check gang_status / the wallet history first.',
package/src/notes.js CHANGED
@@ -5,6 +5,7 @@
5
5
  * v2 suffix = "gang" 0x02 uint32be(revealAfter) keccak256(UTF-8("gang-note:v2\n" salt "\n" conf "\n" revealAfter "\n" text)) (41 bytes)
6
6
  * follow ref = "gang" 0x03 followed note tx hash (37 bytes), right before the note suffix (or last without one)
7
7
  * token links (create) = "gang" 0x04 UTF-8(website "\n" twitter) uint16be(length), same place (see readTokenLinks; written by LaunchpadV2 creates before CLI 0.10)
8
+ * ref = "gang" 0x05 referrer address (25 bytes), right before the follow ref: [calldata][ref][follow][note] (see readRef)
8
9
  * The text is sent after the tx lands (POST /api/notes), so anyone can check it was written before the trade.
9
10
  * v2 (sealed): the server holds the text and only shows it from blockTime + revealAfter.
10
11
  * Normalization and the commitment format must match the server byte for byte.
@@ -21,7 +22,8 @@ import { websiteError, twitterError } from './links.js'
21
22
  export const MAGIC = '67616e6701' // "gang" + version 1
22
23
  export const MAGIC_V2 = '67616e6702' // "gang" + version 2 (sealed)
23
24
  export const FOLLOW_MAGIC = '67616e6703' // "gang" + 03: follow ref
24
- export const LINKS_MAGIC = '67616e6704' // "gang" + 04: token links (01–04 are never reused)
25
+ export const LINKS_MAGIC = '67616e6704' // "gang" + 04: token links
26
+ export const REF_MAGIC = '67616e6705' // "gang" + 05: who invited this wallet (01–05 are never reused)
25
27
  const MAX_CP = 280
26
28
  const REVEAL_MIN_H = 1, REVEAL_MAX_H = 72
27
29
  const LINK = /https?:\/\/|www\.|t\.me\//i
@@ -120,6 +122,31 @@ export function readFollowRef(input) {
120
122
  return f.length === 74 && f.startsWith(FOLLOW_MAGIC) && TX_RE.test(tx) ? tx : null
121
123
  }
122
124
 
125
+ /**
126
+ * Invite reference (same code as the server's indexer): the wallet's first Gang trade names who invited it.
127
+ * "gang" 05 referrer (25 bytes), lower-case hex without 0x, right before the follow ref and the note suffix, if any:
128
+ * [calldata][ref][follow][note]. gang.fun only counts it on a wallet's first trade.
129
+ */
130
+ export function refSuffix(referrer) {
131
+ const a = String(referrer || '').toLowerCase()
132
+ if (!/^0x[0-9a-f]{40}$/.test(a)) throw new Error('bad referrer')
133
+ return `${REF_MAGIC}${a.slice(2)}`
134
+ }
135
+
136
+ /**
137
+ * The referrer a tx input names, or null. Only one place counts: the 25 bytes right before the follow ref (when the
138
+ * input has one) and the note suffix, so one input names at most one referrer.
139
+ */
140
+ export function readRef(input) {
141
+ const s = String(input || '').toLowerCase()
142
+ const c = readNoteCommit(s)
143
+ let end = s.length - (c ? (c.version === 2 ? 82 : 74) : 0)
144
+ const f = s.slice(Math.max(0, end - 74), end)
145
+ if (f.length === 74 && f.startsWith(FOLLOW_MAGIC) && TX_RE.test(`0x${f.slice(10)}`)) end -= 74
146
+ const r = s.slice(Math.max(0, end - 50), end)
147
+ return r.length === 50 && r.startsWith(REF_MAGIC) && /^[0-9a-f]{40}$/.test(r.slice(10)) ? `0x${r.slice(10)}` : null
148
+ }
149
+
123
150
  /*
124
151
  * Token links (create only): the creator's website and X (Twitter) link, in plain text since they're public anyway.
125
152
  * "gang" 04 UTF-8(website "\n" twitter) uint16be(payload bytes), right before the note suffix (or last without one):