Pin rewards are not actively paid out right now (ops settlement timers are off). Set your Peer ID and keep pins up anyway. Details: TTT tokenomics.
| What you can do | Desktop pinner |
|---|---|
| Everything in the web catalog | Yes — plus free download |
| Keep your own durable copy (pin) | Yes — bundled Kubo |
| Upload releases (bytes on your node) | Yes |
| Earn TTT for pinning | Not actively paid yet |
You still need the in-app wallet on Arbitrum One (see Get the app). The web catalog cannot pin.
1. Use the desktop app
Install the Linux AppImage or macOS .app when builds ship
(Get the app). The UI IPFS status line should
show local Kubo, then the private swarm once the key is fetched. The API binds
127.0.0.1:15001 (local only). No CORS setup.
Do not point the product at Homebrew or IPFS Desktop on port 5001.
Quit from the tray and relaunch if sidecars look stuck.
2. Set your IPFS Peer ID
In the app: Pin Rewards → use this node, or Edit profile → IPFS Peer ID. Verification maps that Peer ID to the wallet that controls your profile. Without it, pins cannot be attributed to you when rewards are on.
Do not publish the catalog / operator Peer ID — those are reserved.
3. Download, pin, and stay online
- Unlock a format with Pay TTT or Free download (desktop only for free download).
- Click Download and Pin. The app pins the CID on your node and
can save files under
Artist - Album [year] [FORMAT]in a folder you pick. - Content pins are named like
tT release: <artist> - <album> [<format>]. - Keep the app (and its Kubo sidecar) running across reward periods. Continuous availability is what counts when settlement is active — not a single spot check.
4. Private swarm
Gated catalog files live on the Torrentech private swarm, not
public IPFS. The desktop sidecar fetches the swarm key at start and joins the mesh.
Until the key is on disk, local Kubo stays isolated — wait for the IPFS line to show
private swarm before relying on pin/add of gated CIDs.
Prod IPFS bootstrap (already used by the app):
/ip4/95.217.135.193/tcp/4002/p2p/12D3KooWSrKeJ8jinMaDzBJDKPycKU99AiVvth7bNXkkY2oSCwPhA repo with the Torrentech swarm key cannot also join the public IPFS network. That is expected for the bundled node.
5. Optional tuning
For larger libraries: prefer an SSD-backed datastore, keep connection manager limits sane, and use a roots / pinned reprovide strategy rather than reprovide-all. Flatfs plus reprovide-all does not scale well on big nodes.
Troubleshooting
- “Local IPFS node not reachable…” — sidecar Kubo is down. Quit from the tray and relaunch. Archives still download via the gateway; only pinning is skipped.
- Pin fails for catalog releases — usually not yet on the private swarm. Wait for the IPFS status line, then retry.
- Pinned but no TTT — expected while settlement is off. Confirm Peer ID matches the node that is providing the CID.
- Help — #torrentech:matrix.org.
How rewards will work
- Only pinning of release content is rewarded — not uploading or moderating.
- Per-pin mint amount is dynamic (scales with remaining mintable supply). See tokenomics.
- Settlement happens at period boundaries after verifier attestations. Periods are 10 minutes.
- Today: payouts are not actively running. Stay pinned and keep your Peer ID current.