Field guide

What jackfield is

jackfield is a workshop for reward hooks on Solana coins. A hook is a small, fixed rule that decides where a coin's trading fees go: how often holders get paid, which wallets count, and how big each share is. You build it on a jack panel, by plugging cords into jacks, the way studios route audio.

A jackfield coin launches on Meteora's Dynamic Bonding Curve. Every trade pays a 2.5% fee. Meteora keeps 0.5%, the other 2% runs into your hook, and the hook splits it between holders and the reserve every round. Holders receive SOL in their wallet. Nobody claims anything, nobody stakes anything.

Words used in this guide

Quick start

1. Pick a recipe or plug cordsOpen the workbench. Start from Reward loyal holders or drag the plugs yourself: CLOCK sets the round length, GATE the minimum hold, LOYALTY the weighting. The fader sets the holders share.
2. Test itPress Test this hook. Change balances and holding times of up to eight sample wallets and watch each share move. Follow the sample funds shows every lamport.
3. LaunchOpen Launch, add a name, ticker and image, check the attached hook and its fingerprint, then sign with your wallet. The hook is locked from that moment.

Prefer words? Press Describe a hook and write what you want, for example "pay holders every hour by token balance, 90% to holders". See Describe a hook.

Where a fee goes

Every buy and every sell pays the same 2.5%. The split is fixed by the protocol, not by the hook:

Liquidity is locked when the coin graduates from the curve. Rewards build up per coin: no trading means no new rewards.

CLOCK · when rounds run

The amber cord. Plug it into 10, 20, 30, 40, 50 or 60: that is the round length in minutes. Rounds are aligned to the UTC clock, so a 10-minute coin pays at :00, :10, :20 and so on.

Short or long rounds

Short rounds feel alive: wallets see SOL arrive every few minutes. Long rounds make bigger, cleaner payouts and lose less to transaction costs. Amounts too small to send carry over to the next round.

GATE · who counts

The red cord sets the minimum hold: ANY, 10 min, 30 min, 1 h, 2 h or 4 h. A wallet earns nothing in a round until it has held that long. With ANY, a wallet counts from its first block.

Selling resets the clock

Any sale or transfer out, partial or full, resets that wallet's holding time and loyalty to 1x. Its unpaid share returns to the pot for the others. Rewards already sent stay paid. Buying more keeps the holding time.

Shares follow token balance, so splitting tokens across wallets never raises what you earn. A wallet that receives tokens starts its holding time at zero.

LOYALTY · weight

The blue cord. BAL means shares follow token balance only. 2X, 3X and 5X turn loyalty on: a wallet's weight is its balance times a multiplier that grows with time held, reaching the ceiling after the time on the MAX AFTER knob (1 to 8 hours).

The curve is a square root, so early hours count most:

multiplier = 1 + (maxX − 1) × √(min(held, ramp) / ramp)
weight     = balance × multiplier
share      = pot × weight / Σ weight

SPLIT · how much

The green fader sets the holders share of the hook's 2%, from 0 to 100 in steps of 5. The rest goes to the reserve. At 100% the reserve only receives rounding dust; at 0% the hook is a plain fee and holders get nothing, which the panel allows but the recipes never use.

Describe a hook

Write the rule in plain words, up to 600 characters. The reader maps every phrase it knows to a jack, lists what it did not understand, and lists what has no jack at all, with the nearest setting. Your patch changes only when you press Use this hook.

Press Read it.

Test on sample wallets

The Test step runs the same simulate() the round worker runs, with sample fees and up to eight sample wallets. Each row shows whether the wallet qualifies, its weight and why.

• A wallet that does not qualify gets no share.
• If nobody qualifies, the holders part stays in the pot for the next round.
• Shares are computed in lamports with integer math. Rounding dust goes to the reserve, never to a wallet.
• A preview is not a transfer. Figures are gross: before network fees and payout minimums.

Recipes and files

A recipe is a named hook. The recipes page holds the official ones and the ones you saved in this browser. Use in workbench loads it into the panel; nothing launches.

The Recipe menu exports a patch as a small JSON file and imports one back. A recipe file holds settings only, never keys or coin data:

{
  "jackfield": "0.1.0",
  "name": "No paper hands",
  "hook": { "v": 1, "every": 20, "minHold": 60, "maxX": 3, "ramp": 180, "holders": 85 }
}

Copy share link puts the same thing into a URL (/?h=…), so a patch can travel in a message.

Launch a coin

Launch carries your patch into coin setup: name (32), ticker (10), image (PNG, JPG, GIF or WebP up to 4 MB), optional description, X and site, and an optional first buy. Costs are shown before you sign:

How rounds run

A round worker watches every jackfield coin. On each tick of the coin's CLOCK it claims the fees from the pool, rebuilds holdings from the chain, applies GATE and LOYALTY, splits the pot with simulate() and sends SOL to every wallet that earned more than the payout minimum. Smaller amounts carry over.

Fingerprint

A hook is serialized with fixed key order and hashed with SHA-256. The fingerprint is jf1_ plus the first 16 hex characters. It is written into the coin's metadata, which cannot change, so anyone can check that a coin is paying by the hook it launched with.

import { fingerprint } from "https://jackfield.vercel.app/lib/jackfield.js";
const fp = await fingerprint({ every: 10, minHold: 0, maxX: 5, ramp: 240, holders: 80 });
fp.id;  // "jf1_14ff4d6f13ca442f"

Dry runs and Explore

Explore lists live coins on Meteora's bonding curve and runs your current patch over each coin's real 24 h volume: holder pot per day and per round. Payouts goes further: it takes the last ~300 real trades of a coin, rebuilds who held what, and replays your hook round by round. Every row links the last real trade of that round.

jackfield.js

All the math on this site lives in one ES module with no dependencies. The workbench, recipes, explore and payouts pages import it from the same address you can.

import * as jf from "https://jackfield.vercel.app/lib/jackfield.js";

const hook = jf.RECIPES[0].hook;
console.log(jf.describe(hook));
console.log(jf.simulate(hook, 1, [{ balance: 1000, minutes: 0 }, { balance: 1000, minutes: 240 }]));

<script type="module">
  import { parse, describe } from "https://jackfield.vercel.app/lib/jackfield.js";
  document.body.textContent = describe(parse("hourly, 90% to holders").hook);
</script>

curl -O https://jackfield.vercel.app/lib/jackfield.js
node --input-type=module -e 'import("./jackfield.js").then(j => console.log(j.describe(j.DEFAULT)))'

Node 20+ needs the file saved with an .mjs extension or a "type": "module" package.

API reference

Dry-run a live coin in six lines

import * as jf from "https://jackfield.vercel.app/lib/jackfield.js";
const [coin] = await jf.meteoraCoins();
const trades = await jf.poolTrades(coin.pool);
const rounds = jf.dryRun(jf.DEFAULT, trades);
console.log(coin.symbol, rounds[0].toHolders, "SOL to", rounds[0].wallets, "wallets");

Press Run dry run.

Limits and threat model

What hooks cannot do: burn supply, buy back, pay a dev or team wallet, pay in anything but SOL, pick random winners. The reader in Describe a hook says so when you ask.

$JACKFIELD

$JACKFIELD is the coin that runs this panel. It launches with the same hook anyone can patch here, no special jacks: rounds every 10 minutes, 80% of the 2% to holders, loyalty up to 5x after 4 hours.

FAQ

Do holders need to claim or stake?

No. Holding the coin in a wallet is enough. SOL arrives every round the wallet qualifies.

Why is my reward zero in the test?

Either the wallet holds no tokens, or it has not passed the GATE yet. The Why column says which.

Can I change a hook after launch?

No. Patch a new one and launch a new coin. That is the point of the fingerprint.

Where do the Explore numbers come from?

GeckoTerminal for Meteora pools and trades, DexScreener for $JACKFIELD once it trades. Nothing is estimated beyond the hook math shown on each card.

Is the reserve a creator fee?

No. Creators get 0%. The reserve funds the round worker and the panel, and catches rounding dust.