LinkSpin test area: InstantAdPay engine fork rebranded, network registry, sponsor carry-over with engine activation and claim window, rotator with /r/ redirects, link-domain mini-sites

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

docs/PARTNER-KIT.md

@@ -0,0 +1,68 @@
+# LinkSpin Partner Kit (site owners)
+
+*Plain-text version of the shareable page. Written for site owners who already know Marty and already run a downline builder.*
+
+Video overview (4 min 46 s): https://coolify-saasytop.nyc3.digitaloceanspaces.com/promo/partner-overview.mp4
+
+## Why I built it
+
+You know I've been running ad sites for years, the kind your members already know: buy a package, run banners and text ads, click for credits. Two of mine, Faucet Wave and Tier One Ads, ran on a licensed script. The vendor went out of business, their license server went dark, and it crippled licenses that were fully paid. The sites died overnight and nothing I could do would bring them back.
+
+So I built LinkSpin from scratch as part of the Crypto Team Build Network. No vendor, no license server, and the part that always went wrong on ad sites, the money, is handled by a verified smart contract on Polygon instead of by me. When a package sells, the contract splits the payment and sends it in the same transaction. I never hold member funds, so there is no back office, no payday, and nothing anyone can switch off.
+
+## What LinkSpin is
+
+An advertising platform where the ad spend in your line pays you. Members join free with an email address, no password and no wallet on day one. They earn credits by viewing ads and can run their first campaign for zero dollars. When they want more reach they buy an ad package, and every package that sells is split by the contract the moment it sells.
+
+- Seven ad formats: banners, text ads, login ads, solo ads to member inboxes, video, featured links and verified visits. Views are timed on the server.
+- Banner and text ads also push out to Network Ad Space, a partner rotation across other member sites.
+- Daily caps, country tiers, start and end scheduling, and a balance rule that reserves a campaign's budget when it starts.
+- Full WalletConnect integration: members link MetaMask, Trust, Phantom, SafePal or any WalletConnect wallet with one tap and one free signature, mobile or desktop, and buy or get paid straight from that wallet. No custody on my side.
+- Every payout is a public transaction on Polygon. Splits and qualification rules are constants in a verified contract the operator cannot change.
+
+## How the money moves
+
+Every package splits the same way, in the same transaction: 50% direct sponsor, 20% level 2, 10% level 3, 20% platform. On a $20 package: $10, $4, $2, $4. A level with no qualified member passes its share up to the next qualified person above.
+
+Qualification is earned, never bought. Every direct buyer pays their sponsor 50% from their first package. Two qualifying buyers ($20 or larger) open level 2, five open level 3.
+
+| Package | Price | Credits |
+|---|---|---|
+| Micro | $5 | 500 |
+| Activation (the qualifying buy) | $20 | 2,000 |
+| Builder | $50 | 5,500 |
+| Growth | $100 | 12,000 |
+| Leader | $250 | 32,500 |
+
+## What your members get
+
+- A free start: join by email, view ads, earn credits, run a real campaign for nothing.
+- Your promo credits on top, added the moment they join with your code.
+- Instant, public payouts in POL to their own wallet, checkable on Polygonscan.
+- Tools: invite message, social posts, email swipes, a banner kit in every size, objection answers, a public profile wall.
+- Training videos and written team-building plays.
+- A holding tank so members who arrive without a sponsor get adopted by qualified builders.
+- Coaching built in: next-move card, nudges, and a live payments topic on Telegram.
+
+## What you get for listing it in your builder
+
+- Your spot at the top: you join directly under the company at the top, no sponsor in between, via the company link Marty sends you. Claim it by activating your account with at least the $20 package.
+- Your own promo code: reusable, adds free ad credits per redemption, optional cap and expiry, one use per account, every redemption logged and visible.
+- Your own line: your join link in your builder puts every member under you; each buyer pays you 50% of their first package and every one after, and their buyers open your level 2 and 3 shares.
+- Ready-made creatives: banners in 468x60, 728x90, 300x250, 160x600, 120x600, 1200x630, text ad copy, email swipes, a program description.
+- A bridge page for your brand on request, in LinkSpin's design, carrying your code.
+- Attribution you can check: signups and buyers are tagged with their source.
+
+## Setting it up
+
+1. Join with the company link Marty sends you (top placement, no sponsor in between) and pick your username. Your link: linkspin-test.saasy.top/join/yourname
+2. Send Marty your username and the site. He mints your code (for example YOURSITE) with the agreed credits.
+3. Add LinkSpin to your builder with https://linkspin-test.saasy.top/join/yourname?promo=YOURSITE
+4. Use the banners and text ads from the kit. Existing members type the code into "Have a promo code?" on their Overview.
+5. Link a wallet, switch on payouts, and activate with at least the $20 package to claim your spot at the top.
+
+## The honest part
+
+LinkSpin sells advertising. Members earn from the ad packages people in their line buy, and nothing else. There is no earn-without-referring option, on purpose. No income is guaranteed, results depend on effort, and cryptocurrency involves risk of loss. The contract, the ledger and every payout are public.
+
+Contact: Marty Bostick, marty@marketingwithmarty.com, linkspin-test.saasy.top, t.me/cryptoteambuild

docs/PROMO-ANGLE-VIDEOS-PLAN.md

@@ -0,0 +1,69 @@
+# LinkSpin angle videos + squeeze pages (plan, 2026-09-09)
+
+Same machine RM Circle runs: a short hook video per angle, a matched squeeze
+page at `linkspin-test.saasy.top/join/<you>?v=<angle>`, a card in Promo tools with the
+matched link, and paste-ready copy. Draft for Marty's review. Nothing here is
+built yet except what "Already in place" lists.
+
+## Already in place
+
+- Join links: `/join/<username | share code | member #>` set the sponsor cookie and 302 to the home page. No `?v=` handling yet.
+- Promo tools pane: personalized posts, one email swipe, banner wall link, banner images. No videos, no matched links.
+- Home page has the signature visuals to reuse: the animated ledger mockup (member #7 buys, level 1/2/3 payouts land), the 3-generation isometric viz, the package ladder.
+- Free distribution for the finished videos: the video ad format on the site itself (house ads, no cost) and NAS syndication for banner/text.
+- Video pipeline from RM Circle: HyperFrames (Node 22) + ElevenLabs "Marty Normal Voice", build.py timing from VO files, lint, render, loudnorm, compress, hash-named under `public/v/`.
+
+## Contract facts every script must stay inside
+
+- Packages: $5 / $20 / $50 / $100 / $250 mint 500 / 2,000 / 5,500 / 12,000 / 32,500 credits. One credit = one cent of ad delivery.
+- Split on every purchase, in the same Polygon transaction: 50% direct sponsor, 20% level 2, 10% level 3, 20% platform. Paid to wallets, nothing to claim.
+- Qualification to receive: level 1 pays any activated sponsor; level 2 needs 2 qualifying buyers ($20+); level 3 needs 5.
+- Seven ad formats: banner, text, login, solo, video, featured link, verified visits. Members earn credits by viewing.
+- Join is free by email. Wallet comes out at purchase or when switching payouts on.
+- Dollar package prices are fixed constants and may be spoken. POL amounts and POL/USD are never baked into audio or frames (evergreen rule).
+- Every video ends on the disclaimer card: "No income guaranteed. Results depend on your effort. Crypto involves risk of loss."
+
+## The five angles
+
+| key | working title | hook (first line) | for whom | shape | proof beat |
+|---|---|---|---|---|---|
+| `instant` | Paid before the page reloads | "What if your commission landed before the thank-you page finished loading?" | everyone; flagship | PAS, ~60s | ledger rows animate: purchase, three payouts, same block |
+| `adspend` | You were buying traffic anyway | "Every ad dollar you have ever spent went one direction. Out." | marketers who buy ads | AIDA, ~55s | package ladder + "your buyers' ad spend pays your line" |
+| `free` | Watch first, spend never | "You can run your first ad campaign here for exactly zero dollars." | tire kickers, earn-side | PAS, ~50s | earn credits by viewing, welcome credits, first campaign |
+| `ledger` | No back office. No payday. | "Your last affiliate program paid you on the 15th. If it paid you." | skeptics, burned affiliates | PAS, ~55s | Polygonscan / live ledger as the payroll |
+| `two` | Two buyers open level two | "Two buyers. Then five. That is the whole ladder." | builders | AIDA, ~55s | 3-generation viz lights up 50 / 20 / 10 |
+
+Recommended first three: `instant`, `adspend`, `free`. `ledger` and `two` follow once the page mechanism is live. Landscape 16:9 for the squeeze page; a 9:16 cut of each for social if Marty wants it.
+
+## Squeeze page mechanics
+
+- `/join/<token>?v=<angle>` serves `join.html`: hook headline, video with poster, three proof chips (same transaction, public ledger, join free), "You're joining under @username", inline email join. Plain `/join/<token>` keeps redirecting to the home page.
+- Sponsor cookie set exactly as today. The `v` also rides into the account (`sponsor_ref` stays as is; add `joined_via`) so we can see which hook converts.
+- Per-angle og/twitter tags with `og:url` INCLUDING `?v=` (Facebook canonicalizes shares to og:url; RM Circle lost its variants once this way).
+- Promo tools: one card per video with preview, "Copy matched link", download buttons for both cuts, a post per network, an SMS-length message, and share buttons (Text, WhatsApp, Telegram, Copy).
+- Each finished video also goes live as a house video ad and its squeeze page as a house login ad.
+
+## Production pipeline (mirrors RM Circle)
+
+1. Scripts: written from this brief through the bv-tester1 engine with the contract facts pasted in, then checked line by line against the facts above. No em dashes, no income claims, no POL figures.
+2. Project per video at `D:\Projects\HighRisk\onchain-ad-membership\video-<angle>` (assets/scenes.json, tts.cjs, build.py, index.html), same as `video-phone`.
+3. Silent draft first, rendered with the site palette (mint #43e8c3 on #0b1512, Sora display, mono ledger rows). Marty approves visuals and copy.
+4. Voice: ElevenLabs clone by default, or Marty records to a teleprompter script (6 files, vo1 to vo6). Timing re-derives from the audio either way.
+5. Render 1080p30, loudnorm to -14 LUFS, compress (crf 26, faststart), hash-name into `public/v/`, poster frame, og image per angle.
+6. Ship the squeeze page, promo cards, house ads, and the chatbot answer update together.
+
+## Order of work
+
+1. Marty picks the first three angles and the voice route.
+2. Five scripts drafted and verified; Marty approves.
+3. Squeeze page + og tags + promo cards shipped with poster placeholders, so links work before videos exist.
+4. Silent drafts, approval, voiced finals, deploy.
+5. House ads placed, launch posts in Marty's voice on massifly and Telegram.
+
+## Decisions for Marty
+
+- Which three angles first? (Recommendation above.)
+- Voice clone or your own recording?
+- Squeeze page CTA: inline email join (recommended) or send to the home page?
+- Do you want 9:16 cuts for socials from day one?
+- Scripts through the Branded Voice engine, or written directly in your style?

docs/TEAM-BUILDING-PLAYS.md

@@ -0,0 +1,84 @@
+# LinkSpin team-building plays
+
+Working doc, 2026-09-09. Three ways to build a line, written so a member can pick one and run it. Every number below comes from the live contract and rate table (50 / 20 / 10 / 20 split; qualifying buyer = a direct who buys a $20+ package; level 2 opens at 2 qualifying, level 3 at 5; milestone credits 10 / 25 / 50 / 100; featured strip 40 credits a day; one broadcast a day; wall position 2 at 2 qualifying, position 3 at 5).
+
+## The one rule under all three plays
+
+Unqualified levels pass up. If someone on your level 2 buys before you have 2 qualifying buyers, that 20% does not wait for you. It goes to the next qualified sponsor above you (or the platform). Same for level 3 and 5. So whatever play you run, the first job is the same: get qualified before your line gets busy. The dashboard "Your next move" card is the ladder; the plays are how you climb it.
+
+## Play 1: Wide and teach ("the fifty play")
+
+Who it fits: someone with an audience, a list, a group, or traffic they can point somewhere. Time-rich or reach-rich.
+
+Why it works: every direct who buys is 50% to you, instantly, forever. Directs are the only thing that qualifies you. And the teaching is what fills levels 2 and 3 without you doing anything extra: your directs' buyers are your 20%, their buyers are your 10%.
+
+The move:
+1. One new conversation a day, minimum. Use the Text a friend and Social posts in Promo tools; every piece already carries your link.
+2. Point paid traffic at an angle lander, not the bare link: `?v=adspend` for advertisers, `?v=free` for freebie seekers, `?v=instant` for the crypto-curious.
+3. Every new direct gets the same three sentences from you inside 24 hours (sponsor chat or one broadcast): "Pick your username. Link your wallet and switch on payouts. Send your link to one person today." That is the whole teaching. They teach it to their people.
+4. Run the network's own ads at your link: buy a package, or claim the daily 5 credits, and spend the credits on a Featured link (40 credits a day) or a text ad pointed at your angle lander. Recruits from inside the network already understand the product.
+
+Scoreboard: Joined your line (should climb daily), Qualifying buyers (2 then 5), then watch level 2 and 3 rows appear in My line.
+
+Ceiling: none on width. Weakness: shallow lines churn if you skip step 3.
+
+## Play 2: Two, then down ("the depth play")
+
+Who it fits: someone with a small circle who would rather coach two people well than pitch twenty.
+
+Why it works: two qualifying buyers open level 2 (20%), position 2 on your wall, the Circuit badge, and 50 bonus credits. From there, every person your two bring in pays you 20%, and every person those people bring in pays you 10% (once you reach 5). Your effort goes into two relationships instead of a funnel.
+
+The move:
+1. Get two directs to a $20+ package. Sit with them on the buy if you have to (Trust Wallet needs a POL cushion; SafePal or MetaMask are smoother).
+2. Coach them to their two. Sponsor chat daily for the first week. One broadcast a day to your directs with a single ask each time.
+3. Set your line banner to your team's meeting place (Telegram group, a training page). Every new member three levels down meets it on their welcome tour. That is how your coaching reaches people you never directly recruited.
+4. Keep adding directs until you have five. This is the catch in the depth play: level 3 only opens on five qualifying directs of your own. Two deep, coached well, gets you a healthy 20% level. It does not get you the 10% level.
+
+Scoreboard: Qualifying buyers 2, then level 2 count in My line rising, then your directs' own Qualifying buyers (ask them, or read their wall page).
+
+Ceiling: level 2 income until you personally hit five. Strength: the stickiest lines come from this play.
+
+## Play 3: Five and wide ("the combination", recommended default)
+
+Who it fits: anyone willing to do both. This is the play the dashboard ladder is actually built for.
+
+The move, in order:
+1. Sprint to five qualifying directs. Nothing else matters until level 3 is open: that is Nexus, wall position 3 (your whole public page runs your own links), 100 bonus credits, and the full 50/20/10.
+2. Then split the day. Mornings wide: one new conversation, one post, one ad running. Evenings deep: read My line, message the three newest directs, send the broadcast.
+3. Coach the 2-then-5 rule down the line. Each of your five gets pushed to two (your level 2 fills), then to five (your level 3 fills). Use the achievements Share links; people copy what they see rewarded.
+4. Book the featured strip for 7 days whenever you have 280 credits spare. Ten slots a day, every member sees it.
+
+Scoreboard: all four tiles, plus Earning levels on the Overview (buyers referred, level open, how many to next).
+
+## Opening move: Qualified Start (works with any play)
+
+Qualification is earned by buyers, never bought, but you can be your own first buyers, openly. Under Buy packages, link a second wallet you own as a position. When it buys a $20 package the contract counts it as a qualifying buyer, half the purchase returns to your main wallet, and its credits pool with yours. Two positions open level 2 the same day (about $20 net for $40 of credits); five open level 3 (about $50 net for $100). Say it plainly: your own money, your own wallets, a faster start, never an income promise.
+
+## Which play fits you
+
+| You have | Run |
+|---|---|
+| A list, a group, or ad budget | Wide and teach |
+| A few close people and patience | Two, then down |
+| An hour a day and a phone | Five and wide |
+
+## First 30 days (any play)
+
+- Day 1: username, wallet linked, payouts on, welcome tour done (25 credits). Send the link to one person.
+- Days 2 to 7: one conversation a day. Claim the daily 5 credits. First buyer (25 bonus credits).
+- Days 8 to 14: second qualifying buyer. Level 2 open. Set your line banner. First broadcast.
+- Days 15 to 30: coach the two to their two. Add directs three, four, five. Level 3 open by day 30 is the stretch goal.
+
+## Messages that fit the plays
+
+- Wide: "I run ads anyway. This one pays me in the same transaction the buyer's package sells, on a public ledger. Free to join by email: {{link}}"
+- Depth: "I need two people who will actually do this with me, not twenty who will look at it. You are one of the two I thought of. {{link}}"
+- Combo, to a new direct: "Three things today: username, wallet on, one person. I will check in tomorrow."
+
+No income is guaranteed. Results depend on your effort. Crypto involves risk of loss. LinkSpin sells advertising; it is not an investment.
+
+## Where this should live on the site (proposal, not built)
+
+- Promo tools: a "Plays" pill with the three plays and the fit table.
+- Sponsor coaching panel (pending build): the coach sees which play each direct is on, from their buyer count and line shape.
+- Training: a short video per play once the plays are approved.