Platform Donations

Platform Donations

Learn how SOCI4L handles AVAX donations through profiles and the platform’s smart contract.

Donations
Last updated: 3/9/2026

SOCI4L lets visitors send AVAX donations directly to profile owners, without any custodial balances. All donations are processed by the DonatePayment smart contract on Avalanche C‑Chain, which automatically splits each payment between the creator and the platform treasury.

How donations work on profiles

On a public profile page, visitors can:

  • Click the Donate button to open a donation modal.
  • Choose a quick amount (for example 0.1, 0.5 or 1.0 AVAX) or enter a custom amount.
  • Optionally add a short message to accompany the donation.

The donate button is only shown when:

  • You are viewing someone else’s profile (it is hidden on your own profile to avoid self-donations).
  • The profile owner has donations enabled in their Settings → Donations tab.

When the donor confirms the transaction in their wallet, the payment is sent on-chain via the DonatePayment contract. After confirmation, SOCI4L shows a visual celebration (confetti or other effects depending on the profile’s donation settings).

Smart contract & fee model

All platform donations go through the DonatePayment contract with the following rules:

  • Network: Avalanche C‑Chain.
  • Minimum amount: 0.01 AVAX (to avoid dust transactions).
  • Platform fee: 3% of the total amount.
  • Creator share: 97% of the total amount.

When a donation succeeds:

  • 3% is sent immediately to the platform treasury address.
  • 97% is sent directly to the recipient’s wallet.
  • A DonationSent event is emitted on-chain, recording sender, recipient, totalAmount, recipientAmount, platformFee, message and timestamp.

There are no custodial balances or delayed payouts. Every donation settles directly on Avalanche and can be verified on a block explorer.

Donation modal details

The donation modal shows:

  • The recipient’s display name and address.
  • The chosen donation amount.
  • A breakdown of platform fee and recipient amount based on the 3% fee rule.

The modal enforces the minimum donation of 0.01 AVAX and will not proceed with lower amounts.

Alerts and profile settings

Profile owners can control some aspects of the donation experience from Settings → Donations:

  • Toggle Accept incoming donations on or off. When disabled, the Donate button is hidden on their profile.
  • Select the alert visual effect shown after a successful donation (confetti, heart, star or fire).

These settings change only the user experience around donations. The underlying on-chain donation logic (3% fee, 97% creator share, DonatePayment contract) remains the same.

Embed widget and extensions

In addition to the profile Donate button, SOCI4L also exposes donations through:

  • A Donate Embed Widget (/embed/donate/[id]), which renders a compact “Powered by SOCI4L” donate card that can be embedded on external websites via an <iframe>. Clicking the button opens the profile’s ?action=donate link on soci4l.net.
  • A browser extension that can show a SOCI4L donation button on supported X (Twitter) profiles. When used, donations still go through the same DonatePayment contract and never store funds inside the extension itself.

All of these entry points share the same on-chain donation path and fee model; they only differ in where the button is displayed.