T

martbost a727ab1ce5 Payment trace: self-serve "who was paid, who was skipped and why" per purchase (Earnings tab + admin member card)

Marty, 2026-09-16, after the third "why didn't my sponsor get paid" thread of the day (livedreams / gracie25,
Morten / Terry's linked wallets). GET /api/my/trace?who=<#|username> (yourself, anyone up to 3 levels
below you, or your own 3 uplines) and GET /api/admin/trace?who= list every purchase the member was
part of, newest first: buyer, sponsor, package, then levels 1-3 with the recipient, the skipped
positions and the reason ("not qualified: had N of 2 qualifying buyers then"), the platform share, and
a verify link. Linked extra wallets are named after their owner. Earnings tab card "Trace a payment";
admin member card gets a "Payment trace" section; chatbot canned answer + AI prompt route the
question there.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

2026-09-16 12:24:53 -05:00

docs

Partner page + kit: 'I've been running ad sites for years' (present tense)

2026-09-12 14:19:27 -05:00

public

Payment trace: self-serve "who was paid, who was skipped and why" per purchase (Earnings tab + admin member card)

2026-09-16 12:24:53 -05:00

Pipeline: sponsor follow-up board (stages from the ledger, notes/follow-ups/tags, stage messages into chat), gated by pipelineMode with a coming-soon card until launch; training cards can wait on the same switch

2026-09-15 11:01:03 -05:00

tools

Promo tools built out: posts, text-a-friend, swipes, banner kit, handouts, objections

2026-09-09 05:54:18 -05:00

vendor

InstantAdPay site skeleton: SIWE auth, live chain ledger, join links, buy flow

2026-09-04 12:25:34 -05:00

.gitignore

QA harness: qa/run.sh + walk.mjs (public + member/admin) + earn.mjs (earning flows)

2026-09-09 11:32:13 -05:00

a.jar

Fix referral attribution (username joins) + broadcast rate-limit regression

2026-09-07 06:38:27 -05:00

accounts.js

Admin: member search + drilldown card (identity, chain, credits, line, purchases, payouts, campaigns) with username/sponsor/wallet/credits/delete actions; sortable + filterable admin tables; Earn tab zero-credit button wording

2026-09-13 06:27:07 -05:00

adminmember.js

2026-09-13 06:27:07 -05:00

ads.js

Credit activity ledger: every earn and spend logged with a reason, listed under Campaigns

2026-09-16 08:41:43 -05:00

audit.js

Campaigns table: click sources stacked so the Clicks column stays narrow, card layout up to 900px; audit alert-day persisted, rounding-scale diffs ignored

2026-09-15 07:31:16 -05:00

auth.js

My line: show payouts from an email-only session and across all owned positions

2026-09-12 04:46:22 -05:00

b.jar

Unblock testing: message-your-sponsor entries, video pause-on-blur, tour polish

2026-09-07 06:34:49 -05:00

badge.js

Achievement badge image rendered on the server with ffmpeg (a phone canvas sent a blank card); admin re-post route

2026-09-16 03:30:01 -05:00

blog.js

Header: Leaderboard link

2026-09-14 05:40:26 -05:00

burner.js

Burner: when a campaign's pinned position is dry on-chain, settle the spend from another funded position on the same account (credits are pooled per account)

2026-09-15 12:49:16 -05:00

chain.js

Chain index keeps the full event history (was a 600-event window); one-time rescan from the deploy block

2026-09-16 10:36:28 -05:00

chatbot.js

Payment trace: self-serve "who was paid, who was skipped and why" per purchase (Earnings tab + admin member card)

2026-09-16 12:24:53 -05:00

coach.js

Leaderboard: company account excluded from rankings. Weekly member email: credits unspent, streak, contest rank, tank, line (sponsors by default; memberWeeklyEmail=1 for everyone)

2026-09-14 05:26:23 -05:00

db.js

Credit activity ledger: every earn and spend logged with a reason, listed under Campaigns

2026-09-16 08:41:43 -05:00

docker-compose.yml

InstantAdPay site skeleton: SIWE auth, live chain ledger, join links, buy flow

2026-09-04 12:25:34 -05:00

Dockerfile

Toolkit: ship the rest of the ladder (Spark templates + handout, Circuit Video Maker + split tester, Nexus Leader Ops, grants, co-brand, partner code)

2026-09-14 07:15:43 -05:00

drip-defaults.json

Wall ownership ladder: positions 2 and 3 become the member's own at 2 / 5 qualifying buyers

2026-09-09 15:31:45 -05:00

drip.js

Admin > Releases: email an update to members (pick notes, intro, audience, preview, test, send; opt-outs honoured; send log)

2026-09-14 13:40:01 -05:00

geo.js

Country-tier targeting for campaigns: DB-IP lite lookup, tier lists in Settings, Show-to tiers on every format, geo-restricted ads kept off the network, per-country serve stats

2026-09-11 12:02:40 -05:00

leaderboard.js

Credit activity ledger: every earn and spend logged with a reason, listed under Campaigns

2026-09-16 08:41:43 -05:00

legacy.js

Legacy bridge pages, welcome-back credits, holding-tank alerts

2026-09-12 07:25:32 -05:00

mailer.js

Passwordless sign-in: 6-digit email codes, feature-flagged on SendGrid key

2026-09-04 13:38:11 -05:00

messages.js

Dormant-lead rescue: 10-day warning, 14-day move to the holding tank, Contacted-them reset, dead sponsor links to the tank

2026-09-11 08:06:40 -05:00

nas.js

NAS: syndicated ads click through our redirect so network clicks count and carry the source site

2026-09-10 10:16:22 -05:00

p.jar

Unblock testing: message-your-sponsor entries, video pause-on-blur, tour polish

2026-09-07 06:34:49 -05:00

package-lock.json

Coaching layer + tools: coach your directs (rungs, stalled, one-click nudges), automatic member nudges + weekly sponsor digest, prospects list, per-angle link stats, broadcast templates, Qualified Start calculator, Telegram proof feed, send-failed alerts, admin P&L pane, automatic credit burner (ethers), username lock, home-page comparison, printable checklist, wall link in Promo tools

2026-09-10 07:30:16 -05:00

package.json

2026-09-10 07:30:16 -05:00

pipeline.js

Pipeline advice follows the main wallet's buyer count (what the contract pays on); card states the linked-positions rule; chatbot knows it

2026-09-15 12:26:02 -05:00

promos.js

Toolkit: ship the rest of the ladder (Spark templates + handout, Circuit Video Maker + split tester, Nexus Leader Ops, grants, co-brand, partner code)

2026-09-14 07:15:43 -05:00

README.md

README: sponsor attribution is last touch

2026-09-10 15:51:19 -05:00

releases.js

Header: Leaderboard link

2026-09-14 05:40:26 -05:00

reports.js

Ad reporting + featured rotates one link + clear campaign form on submit

2026-09-07 07:57:12 -05:00

sendy.js

Member updates: audience defaults to newsletter opt-ins (Sendy list status), explicit 'everyone' option; sendy.status()

2026-09-14 13:47:13 -05:00

server.js

Payment trace: self-serve "who was paid, who was skipped and why" per purchase (Earnings tab + admin member card)

2026-09-16 12:24:53 -05:00

snapshot.js

Daily growth snapshot to the Telegram payments feed and shared topic (sign-ups, purchases, POL paid, campaigns, viewing, lifetime totals); admin preview/send-now routes and settings

2026-09-15 12:43:19 -05:00

spaces.js

DO Spaces adapter (feature-flagged): route video uploads to object storage off the volume

2026-09-06 09:24:48 -05:00

syndicate.js

Blog syndication: publishing an article posts it to X and Instagram through Blotato (cover via media upload, once per article, retry button, status column)

2026-09-13 07:20:47 -05:00

tank.js

Holding tank: no releasing an adoptee within 3 days of pickup, dropped adoptions count toward the two-adoption limit, releases posted to the feed and Telegram

2026-09-13 13:50:28 -05:00

toolkit.js

Credit activity ledger: every earn and spend logged with a reason, listed under Campaigns

2026-09-16 08:41:43 -05:00

traffic.js

Admin Traffic tab: referring domains, landing pages, angles, by day

2026-09-12 07:51:01 -05:00

u.jar

Fix referral attribution (username joins) + broadcast rate-limit regression

2026-09-07 06:38:27 -05:00

updates.js

Member updates: paced + retried Sendy opt-in checks (unknowns never cached as declines), explicit recipient list for repairs, recipients recorded on the send log

2026-09-14 14:24:27 -05:00

v.jar

Shorts = portrait-only reel; Watch videos = landscape; badge name in gold

2026-09-07 05:41:17 -05:00

videomaker.js

My line: Activity drop-down on every row, all three levels (last seen, stage, ads today, campaigns, link views, line, wallet, badges, Working/Quiet); Video Maker font override for local runs

2026-09-14 09:56:14 -05:00

README.md

InstantAdPay — site

Membership advertising with immutable on-chain settlement. Zero-dependency Node server (RM Circle pattern): static pages + JSON API + SSE ledger.

Architecture

server.js — http server: pages, /api/*, /join/<id> sponsor links, SSE feed
chain.js — contract reader + persistent event indexer (free public RPCs)
auth.js — SIWE wallet sign-in (EIP-4361), sessions in the volume
accounts.js — site-side records only (free members, last-touch sponsor attribution, handles). The CHAIN is the source of truth for money/credits.
public/ — landing, live ledger, member area; no client libraries

Chain flip (rehearsal → mainnet)

Everything chain-specific lives in data/config.json (volume): {contract, chainId, chainName, explorer, rpcs, deployBlock}. Defaults point at the Amoy rehearsal deployment. Launch = deploy the mainnet contract, wipe accounts.json/sessions.json/chain-index.json, PATCH /api/admin/chain with the mainnet values, set rehearsal:false via /api/admin/site. Same code, different config.

Run

PORT=3100 node server.js       # DATA_DIR defaults to ./data

Admin API auth: Authorization: Bearer $ADMIN_PASSWORD.

Spec: ../CONTRACT-SPEC.md (v1.0.3-frozen). Contracts: ../contracts/.