Loading documentation...
Preparing Ring content
Concepts, value, and typical clone scenarios — less code.
Concepts, value, and typical clone scenarios — less code.
Preparing Ring content
Preparing Ring content
Preparing Ring content
Public pools are community funding jars per clone. Members like and chip in toward a native-token goal; docs embed the same jar via <FutureFeatureWidget />. Product routes live under /dao (not /pools). Money SSOT for card/PayPal chip-ins is PaymentConductor purpose public_pool_contribution — not PSP “donation product” APIs.
Use Founder / Developer tabs in the docs sidebar to filter this page. Sidebar visibility is controlled by lib/docs/audience-curated-docs.ts.
WayForPay hosted Донати, Stripe Checkout submit_type=donate, and PayPal Donate SDK are not the Ring jar SSOT. Ring card/PayPal chip-ins use PaymentConductor.createCheckout({ purpose: 'public_pool_contribution' }) via POST /api/public-pools/[slug]/card-checkout. Native chip-ins use treasury SPL transfer (contributeToPool) — outside Conductor.
| Track | Status | Truth |
|---|---|---|
| Tier A interactive chat | Live | poll, rsvp, dao_jar, share_card remediated (jar refresh, meetup RSVP, poll closeAt cron, locked votes) |
| TD-MONEY-01 Card jar | Live | Purpose public_pool_contribution; settle bumps pledged_native_token via desk oracle FX |
| TD-MONEY-02 Builder payout | Live | On ≥100% funding: auto-complete + treasury pays net (pledged − role fee) to builder’s primary Solana wallet |
| TD-MONEY-03 Escrow | Partial | Anchor program at solana/programs/public-pool (init/contribute/finalize/refund). Donation path live; on-chain escrow contribute needs deploy + IDL wire |
| Dual-currency CTA | Live | PoolContributePanel — fiat for card/PayPal; native symbol for chip-in; shows credit + native balances |
Card jar is not 1:1 fiat↔RING. PublicPool escrow is not production-live. Builder payout is not always full pledged (fee 0 only for admin/superadmin roles by default).
FX SSOT (same as Token Desk): nativeUi = fiatMajor / nativePerMainCurrency via getNativeTokenPerMainCurrencyRate / features/public-pools/lib/public-pool-desk-fx.ts.
Platform fee SSOT: ring-config.json → publicPools.platformFeePercentByRole (defaults: admin/superadmin 0%, confidential 6%, member 7%).
Members fund features and collective goals in your native token (and card fiat converted at the live desk rate). When a jar fills, the opportunity owner receives net native token to their primary custodial Solana wallet — minus your configured role fee. Collective-order forms show this clearly (collectiveJarPayoutNote in opportunities locales).
Card/PayPal purpose public_pool_contribution shares the same ledger and webhooks as store and wallet.
Desk oracle rate is the same FX used when card chip-ins become pledged native units.
dao_jar chat widgets refresh after contribute; post jars from docs or .
Depends-on: card/PayPal jar settle uses PaymentPurpose public_pool_contribution and shared webhooks.
Depends-on: desk oracle nativePerMainCurrency is the FX SSOT for fiat→pledged native.
Same-workflow: dao_jar widgets and PostDaoJarToChatButton after contribute refresh.
Next-step: collective jars pay the opportunity builder wallet when funding hits 100%.
Public pools are community funding jars per clone. Members like and chip in toward a native-token goal; docs embed the same jar via <FutureFeatureWidget />. Product routes live under /dao (not /pools). Money SSOT for card/PayPal chip-ins is PaymentConductor purpose public_pool_contribution — not PSP “donation product” APIs.
Use Founder / Developer tabs in the docs sidebar to filter this page. Sidebar visibility is controlled by lib/docs/audience-curated-docs.ts.
WayForPay hosted Донати, Stripe Checkout submit_type=donate, and PayPal Donate SDK are not the Ring jar SSOT. Ring card/PayPal chip-ins use PaymentConductor.createCheckout({ purpose: 'public_pool_contribution' }) via POST /api/public-pools/[slug]/card-checkout. Native chip-ins use treasury SPL transfer (contributeToPool) — outside Conductor.
| Track | Status | Truth |
|---|---|---|
| Tier A interactive chat | Live | poll, rsvp, dao_jar, share_card remediated (jar refresh, meetup RSVP, poll closeAt cron, locked votes) |
| TD-MONEY-01 Card jar | Live | Purpose public_pool_contribution; settle bumps pledged_native_token via desk oracle FX |
| TD-MONEY-02 Builder payout | Live | On ≥100% funding: auto-complete + treasury pays net (pledged − role fee) to builder’s primary Solana wallet |
| TD-MONEY-03 Escrow | Partial | Anchor program at solana/programs/public-pool (init/contribute/finalize/refund). Donation path live; on-chain escrow contribute needs deploy + IDL wire |
| Dual-currency CTA | Live | PoolContributePanel — fiat for card/PayPal; native symbol for chip-in; shows credit + native balances |
Card jar is not 1:1 fiat↔RING. PublicPool escrow is not production-live. Builder payout is not always full pledged (fee 0 only for admin/superadmin roles by default).
FX SSOT (same as Token Desk): nativeUi = fiatMajor / nativePerMainCurrency via getNativeTokenPerMainCurrencyRate / features/public-pools/lib/public-pool-desk-fx.ts.
Platform fee SSOT: ring-config.json → publicPools.platformFeePercentByRole (defaults: admin/superadmin 0%, confidential 6%, member 7%).
Members fund features and collective goals in your native token (and card fiat converted at the live desk rate). When a jar fills, the opportunity owner receives net native token to their primary custodial Solana wallet — minus your configured role fee. Collective-order forms show this clearly (collectiveJarPayoutNote in opportunities locales).
Card/PayPal purpose public_pool_contribution shares the same ledger and webhooks as store and wallet.
Desk oracle rate is the same FX used when card chip-ins become pledged native units.
dao_jar chat widgets refresh after contribute; post jars from docs or .
Depends-on: card/PayPal jar settle uses PaymentPurpose public_pool_contribution and shared webhooks.
Depends-on: desk oracle nativePerMainCurrency is the FX SSOT for fiat→pledged native.
Same-workflow: dao_jar widgets and PostDaoJarToChatButton after contribute refresh.
Next-step: collective jars pay the opportunity builder wallet when funding hits 100%.
Public pools are community funding jars per clone. Members like and chip in toward a native-token goal; docs embed the same jar via <FutureFeatureWidget />. Product routes live under /dao (not /pools). Money SSOT for card/PayPal chip-ins is PaymentConductor purpose public_pool_contribution — not PSP “donation product” APIs.
Use Founder / Developer tabs in the docs sidebar to filter this page. Sidebar visibility is controlled by lib/docs/audience-curated-docs.ts.
WayForPay hosted Донати, Stripe Checkout submit_type=donate, and PayPal Donate SDK are not the Ring jar SSOT. Ring card/PayPal chip-ins use PaymentConductor.createCheckout({ purpose: 'public_pool_contribution' }) via POST /api/public-pools/[slug]/card-checkout. Native chip-ins use treasury SPL transfer (contributeToPool) — outside Conductor.
| Track | Status | Truth |
|---|---|---|
| Tier A interactive chat | Live | poll, rsvp, dao_jar, share_card remediated (jar refresh, meetup RSVP, poll closeAt cron, locked votes) |
| TD-MONEY-01 Card jar | Live | Purpose public_pool_contribution; settle bumps pledged_native_token via desk oracle FX |
| TD-MONEY-02 Builder payout | Live | On ≥100% funding: auto-complete + treasury pays net (pledged − role fee) to builder’s primary Solana wallet |
| TD-MONEY-03 Escrow | Partial | Anchor program at solana/programs/public-pool (init/contribute/finalize/refund). Donation path live; on-chain escrow contribute needs deploy + IDL wire |
| Dual-currency CTA | Live | PoolContributePanel — fiat for card/PayPal; native symbol for chip-in; shows credit + native balances |
Card jar is not 1:1 fiat↔RING. PublicPool escrow is not production-live. Builder payout is not always full pledged (fee 0 only for admin/superadmin roles by default).
FX SSOT (same as Token Desk): nativeUi = fiatMajor / nativePerMainCurrency via getNativeTokenPerMainCurrencyRate / features/public-pools/lib/public-pool-desk-fx.ts.
Platform fee SSOT: ring-config.json → publicPools.platformFeePercentByRole (defaults: admin/superadmin 0%, confidential 6%, member 7%).
Members fund features and collective goals in your native token (and card fiat converted at the live desk rate). When a jar fills, the opportunity owner receives net native token to their primary custodial Solana wallet — minus your configured role fee. Collective-order forms show this clearly (collectiveJarPayoutNote in opportunities locales).
Card/PayPal purpose public_pool_contribution shares the same ledger and webhooks as store and wallet.
Desk oracle rate is the same FX used when card chip-ins become pledged native units.
dao_jar chat widgets refresh after contribute; post jars from docs or .
Depends-on: card/PayPal jar settle uses PaymentPurpose public_pool_contribution and shared webhooks.
Depends-on: desk oracle nativePerMainCurrency is the FX SSOT for fiat→pledged native.
Same-workflow: dao_jar widgets and PostDaoJarToChatButton after contribute refresh.
Next-step: collective jars pay the opportunity builder wallet when funding hits 100%.
/daopublicPools in ring-config.json) — fee map + autoPayoutOnGoalMet.SOLANA_RPC_URL, SOLANA_TREASURY_PRIVATE_KEY) so native chip-ins and builder payouts can move SPL.getNativeTokenPerMainCurrencyRate.solana/programs/public-pool and set NEXT_PUBLIC_PUBLIC_POOL_PROGRAM_ID./dao/[slug] and confirm pledged native rises by desk-converted units, not 1:1 fiat.<FutureFeatureWidget poolSlug="…" /> — members like + chip in from the page.dao_jar — same panel; totals refresh via refreshOpenDaoJarMessages.completed → treasury pays net RING to builder wallet.| GET/POST | /api/public-pools | List / upsert future_feature stats |
| POST | /api/public-pools/signal | Like toggle |
| POST | /api/public-pools/contribute | Native initiate |
| POST | /api/public-pools/contribute/confirm | Native confirm + jar refresh |
| POST | /api/public-pools/[slug]/card-checkout | Conductor card/PayPal checkout |
| * | /api/admin/public-pools… | Admin CRUD + status |
Settle: lib/payments/conductor/handlers/public-pool-contribution.ts → settlePublicPoolCardContribution (idempotent on orderReference). Webhooks: WayForPay / Stripe / PayPal dispatcher branches on purpose === 'public_pool_contribution'.
Optional processor override: PAYMENT_PUBLIC_POOL_CONTRIBUTION_PROCESSOR (lib/payments/payment.config.ts).
| Module | Responsibility |
|---|---|
features/public-pools/services/public-pool-service.ts | Totals, queue gate, auto-complete, builder payout |
features/public-pools/services/public-pool-contribute.ts | Native treasury chip-in |
features/public-pools/lib/public-pool-desk-fx.ts | Desk-oracle FX |
features/public-pools/lib/public-pool-platform-fee.ts | Role fee map |
features/public-pools/lib/public-pool-escrow-gate.ts | NEXT_PUBLIC_PUBLIC_POOL_PROGRAM_ID / PUBLIC_POOL_PROGRAM_ID |
lib/payments/conductor/settle-public-pool-contribution.ts | Card settle → pledged_native_token |
features/chat/lib/refresh-open-dao-jar-messages.ts | Chat snapshot sync |
solana/programs/public-pool | Anchor: init_pool / contribute / finalize_success / refund_contributor |
Card checkout accepts amount_fiat or amount_native and always stores both + nativePerMainCurrency on payment metadata before redirect.
When autoPayoutOnGoalMet and funding ≥ 100%:
completedpayout_wallet_address or builder’s primary native walletfeePercent = resolveBuilderPlatformFeePercent(builderRole)net = pledged − fee; transferTokenFromTreasury(wallet, net)public_pool_payout with gross/fee/feePctCollective-order copy: locales/*/modules/opportunities.json → collectiveJarPayoutNote.
Donation mode (treasury SPL) is the live path. Escrow contribute requires: deploy program → set NEXT_PUBLIC_PUBLIC_POOL_PROGRAM_ID → IDL client wire → store on_chain { pool_pda, vault_ata } per jar. Do not document escrow as live in production.
| Var | Use |
|---|---|
SOLANA_RPC_URL | Chain RPC |
SOLANA_TREASURY_PRIVATE_KEY | Native chip-in + builder payout |
NEXT_PUBLIC_PUBLIC_POOL_PROGRAM_ID / PUBLIC_POOL_PROGRAM_ID | Escrow gate (optional; not yet in env.local.template) |
PAYMENT_PUBLIC_POOL_CONTRIBUTION_PROCESSOR | Optional per-purpose PSP override |
| Standard WFP / Stripe / PayPal secrets | Same Conductor webhooks as other purposes |
public_pools, public_pool_signals, public_pool_contributions (clone-scoped via getPublicPoolConfig().cloneId).
Domain owns money; chat owns dao_jar snapshot. After totals change, always refreshOpenDaoJarMessages. Scorecard: AI-CONTEXT concepts/chat-interactive-type-debt.json — Tier A CLOSED; TD-MONEY-01/02 CLOSED; TD-MONEY-03 PARTIAL.
Deep-dive: conductor types, ledger, and webhook dispatcher.
// features/public-pools/lib/public-pool-desk-fx.ts
// nativeUi = fiatMajor / nativePerMainCurrency
// nativePerMainCurrency from getNativeTokenPerMainCurrencyRate() — same SSOT as Token Desk
// features/public-pools/lib/public-pool-escrow-gate.ts
isPublicPoolEscrowDeployed() // true only when PROGRAM_ID env is set/daopublicPools in ring-config.json) — fee map + autoPayoutOnGoalMet.SOLANA_RPC_URL, SOLANA_TREASURY_PRIVATE_KEY) so native chip-ins and builder payouts can move SPL.getNativeTokenPerMainCurrencyRate.solana/programs/public-pool and set NEXT_PUBLIC_PUBLIC_POOL_PROGRAM_ID./dao/[slug] and confirm pledged native rises by desk-converted units, not 1:1 fiat.<FutureFeatureWidget poolSlug="…" /> — members like + chip in from the page.dao_jar — same panel; totals refresh via refreshOpenDaoJarMessages.completed → treasury pays net RING to builder wallet.| GET/POST | /api/public-pools | List / upsert future_feature stats |
| POST | /api/public-pools/signal | Like toggle |
| POST | /api/public-pools/contribute | Native initiate |
| POST | /api/public-pools/contribute/confirm | Native confirm + jar refresh |
| POST | /api/public-pools/[slug]/card-checkout | Conductor card/PayPal checkout |
| * | /api/admin/public-pools… | Admin CRUD + status |
Settle: lib/payments/conductor/handlers/public-pool-contribution.ts → settlePublicPoolCardContribution (idempotent on orderReference). Webhooks: WayForPay / Stripe / PayPal dispatcher branches on purpose === 'public_pool_contribution'.
Optional processor override: PAYMENT_PUBLIC_POOL_CONTRIBUTION_PROCESSOR (lib/payments/payment.config.ts).
| Module | Responsibility |
|---|---|
features/public-pools/services/public-pool-service.ts | Totals, queue gate, auto-complete, builder payout |
features/public-pools/services/public-pool-contribute.ts | Native treasury chip-in |
features/public-pools/lib/public-pool-desk-fx.ts | Desk-oracle FX |
features/public-pools/lib/public-pool-platform-fee.ts | Role fee map |
features/public-pools/lib/public-pool-escrow-gate.ts | NEXT_PUBLIC_PUBLIC_POOL_PROGRAM_ID / PUBLIC_POOL_PROGRAM_ID |
lib/payments/conductor/settle-public-pool-contribution.ts | Card settle → pledged_native_token |
features/chat/lib/refresh-open-dao-jar-messages.ts | Chat snapshot sync |
solana/programs/public-pool | Anchor: init_pool / contribute / finalize_success / refund_contributor |
Card checkout accepts amount_fiat or amount_native and always stores both + nativePerMainCurrency on payment metadata before redirect.
When autoPayoutOnGoalMet and funding ≥ 100%:
completedpayout_wallet_address or builder’s primary native walletfeePercent = resolveBuilderPlatformFeePercent(builderRole)net = pledged − fee; transferTokenFromTreasury(wallet, net)public_pool_payout with gross/fee/feePctCollective-order copy: locales/*/modules/opportunities.json → collectiveJarPayoutNote.
Donation mode (treasury SPL) is the live path. Escrow contribute requires: deploy program → set NEXT_PUBLIC_PUBLIC_POOL_PROGRAM_ID → IDL client wire → store on_chain { pool_pda, vault_ata } per jar. Do not document escrow as live in production.
| Var | Use |
|---|---|
SOLANA_RPC_URL | Chain RPC |
SOLANA_TREASURY_PRIVATE_KEY | Native chip-in + builder payout |
NEXT_PUBLIC_PUBLIC_POOL_PROGRAM_ID / PUBLIC_POOL_PROGRAM_ID | Escrow gate (optional; not yet in env.local.template) |
PAYMENT_PUBLIC_POOL_CONTRIBUTION_PROCESSOR | Optional per-purpose PSP override |
| Standard WFP / Stripe / PayPal secrets | Same Conductor webhooks as other purposes |
public_pools, public_pool_signals, public_pool_contributions (clone-scoped via getPublicPoolConfig().cloneId).
Domain owns money; chat owns dao_jar snapshot. After totals change, always refreshOpenDaoJarMessages. Scorecard: AI-CONTEXT concepts/chat-interactive-type-debt.json — Tier A CLOSED; TD-MONEY-01/02 CLOSED; TD-MONEY-03 PARTIAL.
Deep-dive: conductor types, ledger, and webhook dispatcher.
// features/public-pools/lib/public-pool-desk-fx.ts
// nativeUi = fiatMajor / nativePerMainCurrency
// nativePerMainCurrency from getNativeTokenPerMainCurrencyRate() — same SSOT as Token Desk
// features/public-pools/lib/public-pool-escrow-gate.ts
isPublicPoolEscrowDeployed() // true only when PROGRAM_ID env is set/daopublicPools in ring-config.json) — fee map + autoPayoutOnGoalMet.SOLANA_RPC_URL, SOLANA_TREASURY_PRIVATE_KEY) so native chip-ins and builder payouts can move SPL.getNativeTokenPerMainCurrencyRate.solana/programs/public-pool and set NEXT_PUBLIC_PUBLIC_POOL_PROGRAM_ID./dao/[slug] and confirm pledged native rises by desk-converted units, not 1:1 fiat.<FutureFeatureWidget poolSlug="…" /> — members like + chip in from the page.dao_jar — same panel; totals refresh via refreshOpenDaoJarMessages.completed → treasury pays net RING to builder wallet.| GET/POST | /api/public-pools | List / upsert future_feature stats |
| POST | /api/public-pools/signal | Like toggle |
| POST | /api/public-pools/contribute | Native initiate |
| POST | /api/public-pools/contribute/confirm | Native confirm + jar refresh |
| POST | /api/public-pools/[slug]/card-checkout | Conductor card/PayPal checkout |
| * | /api/admin/public-pools… | Admin CRUD + status |
Settle: lib/payments/conductor/handlers/public-pool-contribution.ts → settlePublicPoolCardContribution (idempotent on orderReference). Webhooks: WayForPay / Stripe / PayPal dispatcher branches on purpose === 'public_pool_contribution'.
Optional processor override: PAYMENT_PUBLIC_POOL_CONTRIBUTION_PROCESSOR (lib/payments/payment.config.ts).
| Module | Responsibility |
|---|---|
features/public-pools/services/public-pool-service.ts | Totals, queue gate, auto-complete, builder payout |
features/public-pools/services/public-pool-contribute.ts | Native treasury chip-in |
features/public-pools/lib/public-pool-desk-fx.ts | Desk-oracle FX |
features/public-pools/lib/public-pool-platform-fee.ts | Role fee map |
features/public-pools/lib/public-pool-escrow-gate.ts | NEXT_PUBLIC_PUBLIC_POOL_PROGRAM_ID / PUBLIC_POOL_PROGRAM_ID |
lib/payments/conductor/settle-public-pool-contribution.ts | Card settle → pledged_native_token |
features/chat/lib/refresh-open-dao-jar-messages.ts | Chat snapshot sync |
solana/programs/public-pool | Anchor: init_pool / contribute / finalize_success / refund_contributor |
Card checkout accepts amount_fiat or amount_native and always stores both + nativePerMainCurrency on payment metadata before redirect.
When autoPayoutOnGoalMet and funding ≥ 100%:
completedpayout_wallet_address or builder’s primary native walletfeePercent = resolveBuilderPlatformFeePercent(builderRole)net = pledged − fee; transferTokenFromTreasury(wallet, net)public_pool_payout with gross/fee/feePctCollective-order copy: locales/*/modules/opportunities.json → collectiveJarPayoutNote.
Donation mode (treasury SPL) is the live path. Escrow contribute requires: deploy program → set NEXT_PUBLIC_PUBLIC_POOL_PROGRAM_ID → IDL client wire → store on_chain { pool_pda, vault_ata } per jar. Do not document escrow as live in production.
| Var | Use |
|---|---|
SOLANA_RPC_URL | Chain RPC |
SOLANA_TREASURY_PRIVATE_KEY | Native chip-in + builder payout |
NEXT_PUBLIC_PUBLIC_POOL_PROGRAM_ID / PUBLIC_POOL_PROGRAM_ID | Escrow gate (optional; not yet in env.local.template) |
PAYMENT_PUBLIC_POOL_CONTRIBUTION_PROCESSOR | Optional per-purpose PSP override |
| Standard WFP / Stripe / PayPal secrets | Same Conductor webhooks as other purposes |
public_pools, public_pool_signals, public_pool_contributions (clone-scoped via getPublicPoolConfig().cloneId).
Domain owns money; chat owns dao_jar snapshot. After totals change, always refreshOpenDaoJarMessages. Scorecard: AI-CONTEXT concepts/chat-interactive-type-debt.json — Tier A CLOSED; TD-MONEY-01/02 CLOSED; TD-MONEY-03 PARTIAL.
Deep-dive: conductor types, ledger, and webhook dispatcher.
// features/public-pools/lib/public-pool-desk-fx.ts
// nativeUi = fiatMajor / nativePerMainCurrency
// nativePerMainCurrency from getNativeTokenPerMainCurrencyRate() — same SSOT as Token Desk
// features/public-pools/lib/public-pool-escrow-gate.ts
isPublicPoolEscrowDeployed() // true only when PROGRAM_ID env is set