Swap Widget — AquaVaults Learn

Swap Infrastructure That Lives On Your Site

Most communities face the same problem when they want to drive swap activity. They point users to an external platform, and in that moment, the community loses control of what happens next. The user leaves the community's environment, the campaign context disappears, and there is no guarantee they complete the intended action.

The Swap Widget solves that by eliminating the need to send users anywhere. Communities can embed AquaVaults swap infrastructure directly into their own website. Users swap without leaving. The campaign context stays intact. The activity happens inside the community's own ecosystem rather than on a platform that has no stake in what the community is trying to accomplish.

For founders and community operators, the implication is straightforward: you built the audience, created the context, and organized the campaign. The Swap Widget helps keep that activity connected to the community ecosystem instead of immediately redirecting users elsewhere.

The Swap Widget is a standalone Solana single-swap interface. Communities embed it into their site and it surfaces a fully functional swap experience within that page — users connect their Solana wallet, configure a swap, and execute it without navigating away. The widget handles one swap at a time and does not run AutoSwap sessions or multi-step sequences.

Community fee routing applies through the widget the same way it does on the main platform. When a community other than AquaVaults is selected and the platform fee is above 0%, the platform fee splits based on the community's listing and current Growth Program tier — Standard communities start at a 50% floor and Founding communities at a permanent 60% floor, rising to 65% at Silver or 75% at Gold, with Partner status adding +10% — and the remainder routes to AquaVaults through the same infrastructure.

Communities embedding the widget can lock several parameters for the experience they present to their members: the community selection, the platform fee percentage, and the visual styling of the widget to better match their own site's design. This lets a community present a consistent, on-brand swap experience without relying on users to configure those details themselves.

The widget also supports custom deep-link flows that can preload buy and sell token selections before the user arrives. Communities can use these links across social campaigns, launch announcements, partner campaigns, and embedded landing pages to create prepared participation flows tied directly into their own ecosystem.

Every swap remains user-controlled throughout. The user connects their own wallet, reviews the swap, and signs it. The widget controls the configuration context. The user controls execution.

Custom Deep Links and Campaign Flows

The Swap Widget becomes significantly more powerful when paired with custom deep links. Communities can construct links that open the widget with a specific swap already configured — the sell token, the buy token, and the community selection preloaded. A user who follows that link arrives in the widget ready to act, with the intended swap already set up for them.

That removes a significant amount of friction from coordinated community participation. Instead of asking members to navigate to a platform, search for tokens, and manually configure a swap, a community can share a single link that prepares the intended flow ahead of time. Users still review the setup themselves and decide whether they want to participate.

Token Launch Campaigns

A community launching a new token can create a deep link that preloads that token as the buy target. Members receive one link, arrive already configured, and can participate in the launch without any additional steps.

Partner Token Promotions

When partnering with another project, a community can generate a deep link preloaded with the partner token. The collaboration becomes a specific, actionable flow rather than a general announcement asking users to go find it themselves.

NFT Community Collaborations

NFT projects working with token communities can create campaign pages where the swap is already prepared. Holders who arrive through community channels see exactly the action they are being asked to take, with no configuration required.

Recurring Community Pushes

Communities running recurring swap campaigns can maintain a standing deep link that reflects their current campaign focus. Members can bookmark it, share it, and return to it as a consistent entry point into community participation.

The Core Shift

Custom deep links transform campaign coordination from directing users toward a general platform into guiding users into a prepared participation flow. Communities can organize clearer, more cohesive campaign experiences while users still retain full control over whether they participate.

Why Communities Care

Communities already do the hard work. They build audiences, sustain attention, run campaigns, and create the conditions that make users want to show up and participate. The Swap Widget gives that effort a more direct return.

When swap activity happens through a community's own embedded widget, the community owns that user experience. The context the community created — the campaign, the story, the environment — stays present throughout the transaction. Users are not context-switching to a platform that knows nothing about the community they came from.

That creates stronger participation loops. When users swap inside a community's site and see the activity tied directly to that community, the connection between their action and the community's mission is clear. It is not abstract. The swap happened here, in this place, for this reason.

For communities that already invest in content, campaigns, and coordination, the Swap Widget is the infrastructure layer that makes that investment go further.

Built for Ecosystem Coordination

The Swap Widget is most powerful when treated as a coordination layer rather than a standalone feature. It pairs naturally with every other AquaVaults tool.

A community running an AutoSwap campaign can pair it with a dedicated widget page — members who visit the page can perform individual swaps through the widget, while the AutoSwap sessions themselves run separately through the main platform. A token launch campaign can combine a deep link with a community announcement, giving every member a direct, prepared path into the launch. A partner collaboration can create an experience where both communities point their audiences to the same embedded swap flow, generating coordinated activity from two different entry points.

The widget also extends AquaVaults beyond its own website. Every community that embeds the widget is bringing AquaVaults infrastructure into a new context — their own — with their own audience. That distribution model means the reach of community-directed swap activity is not limited to users who independently discover the main AquaVaults platform. It grows with every community that integrates the widget into their own ecosystem.

User Control and Non-Custodial Design

The Swap Widget does not change the fundamental trust model of AquaVaults. Whether a user swaps on the main platform or through a community's embedded widget, the experience is non-custodial and user-controlled throughout.

Users Connect Their Own Wallet

The widget does not hold credentials or pre-authorize any transactions. Users connect their wallet directly within the widget interface and maintain full control of it throughout.

No Community Custody

Communities that embed the widget do not gain access to user funds or wallets. The swap infrastructure runs through AquaVaults and Jupiter. Communities provide the context, not the execution layer.

Every Swap Is User-Approved

Deep links and preloaded configurations do not bypass wallet approval. Users still review and sign every transaction themselves. Preconfiguration reduces setup steps — it does not remove user consent.

More Than An Embed

A swap embed is a convenience. The AquaVaults Swap Widget is infrastructure.

The distinction is in what it enables beyond the transaction itself. A generic embed lets users swap on a page. The AquaVaults widget lets communities build campaign flows, coordinate participation, retain their audience, connect into fee routing, lock community selection and fee settings, customize the visual design to match their brand, and create a persistent, reusable entry point into community activity — all from within their own ecosystem.

Communities that use the Swap Widget are not just adding a swap feature to their site. They are integrating a participation layer into it. Every deep link they create is a reusable coordination tool. Every campaign page they build around the widget is a repeatable infrastructure asset they own and control.

That is the difference between a feature and a foundation. The Swap Widget is where AquaVaults infrastructure becomes something communities can own and deploy on their own terms.