Partner Widget

The Unclaimed SOL Partner Widget lets partners add a claim entry point to their own site while keeping the claim experience on Unclaimed SOL infrastructure. Use your own native button and call widget.open() when the user clicks it.

Partner keys are issued manually. Reach out on Discord to request approval, a partner key, and revenue-share terms.

Quickstart

Add the hosted SDK, initialize it with your partner key, and open the widget from your existing button. 

<button id="claim-unused-sol" class="your-native-button">
  Claim unused SOL
</button>

<script src="https://unclaimedsol.com/sdk/unclaimed-sol-widget.js"></script>
<script>
  const widget = window.UnclaimedSolWidget.init({
    partner: "your-partner-key"
  });

  document
    .getElementById("claim-unused-sol")
    .addEventListener("click", () => widget.open());
</script>
Builder: open the Partner Widget Builder.

Configuration

  • partner - required string issued by Unclaimed SOL. The value is normalized internally before it is recorded.
  • autoRender - optional convenience mode if supported by the SDK version you load. For production partner pages, prefer a native button and widget.open().

There is only one partner field: the partner key passed as partner. Do not pass presentation settings. The widget surface shows Unclaimed SOL branding only.

How It Opens

Calling widget.open() opens an iframe modal served by Unclaimed SOL at /partner-widget. Some wallets, including Phantom, may not inject into iframes. When that happens, the iframe shows a top-level fallback CTA so the user can continue on Unclaimed SOL at /partner-widget/continue.

Claim Scope

The Partner Widget is intentionally scoped to empty token accounts. It does not claim buffers, stakes, rewards, LP fees, recovery results, NFTs, max claim mode, or non-empty token cleanup.

Attribution and Revenue Share

Partner keys are used for manual reporting. Claim records include partnerKey and partnerOrigin, but partnerOrigin is client-supplied and is not proof of partner approval. Revenue share percentages and payouts are handled manually outside claim records.

Reach out on Discord for approval, a partner key, and revenue-share terms. Do not assume client-supplied attribution means approval, and do not expect automated payouts.

CSP and Embed Notes

  • Partner pages must allow loading the SDK from https://unclaimedsol.com/sdk/unclaimed-sol-widget.js. If your Content Security Policy restricts scripts, allow https://unclaimedsol.com in script-src.
  • The widget iframe is served by Unclaimed SOL. If your Content Security Policy restricts embedded frames, allow https://unclaimedsol.com in frame-src or child-src.
  • Do not rely on referrer headers for attribution. Use the issued partner key.