Pay with $SAND - A mini-SDK for any website or dApp

The Sandbox DAO Grant Program OPEN: Web3 integration
1

Pay with $SAND

A mini-SDK for any website or dApp

1. Executive Summary

  • A simple “Pay with $SAND” button that any website can drop in next to “Pay with PayPal”.
  • When someone clicks it, a small pop-up asks them to confirm; seconds later the seller receives their $SAND.

Why it matters for The Sandbox

  • Gives $SAND real-world use outside the game: tipping streamers, buying merch, donating to creators.
  • Every payment is recorded on the blockchain, so results are transparent and easy to track.
  • What – @sandbox/pay-with-sand, an npm package exposing
    payWithSand({ amount, orderId })
useSandPaymentStatus(orderId)
    plus an optional PaymentGateway contract that logs each sale on-chain.

2. Problem Statement

Issue Effect
Each partner hand-codes approve + transfer flows Friction, errors, two signature steps
No standard “receipt” on-chain Hard to reconcile sales or split revenue
$SAND mostly stuck in-game Missed adoption opportunities in Web 2/Web 3 apps

3. Proposed Solution

Aspect Details
Package @sandbox/pay-with-sand (TypeScript / React)
Flow One click → EIP-2612 permit → single tx → PaymentDone(orderId, payer, amount)
Tech Solidity ^0.8, wagmi v1, RainbowKit
UX Modal theming, i18n, webhook callback for partner back-ends
Future-proof Contract ready for splits (90/10), refunds, NFT receipt later

3.1 End-to-End Flow

  1. User click → site calls the SDK.
  2. SDK opens a wallet modal (RainbowKit / WalletConnect).
  3. User signs one EIP-2612 permit + pay transaction.
  4. PaymentGateway.sol
    1. pulls the $SAND with transferFrom,
    2. emits PaymentDone(orderId, payer, amount),
    3. (optionally) forwards or splits the funds.
  5. A webhook service listens to the event and notifies the merchant backend.
  6. Backend unlocks the item / credit and returns “confirmed” to the front end.
  7. Front end shows “Payment confirmed” to the user.

Editor _ Mermaid Chart-2025-06-11-175720
Editor _ Mermaid Chart-2025-06-11-1757203840×1499 231 KB

4. Team

Name Role Experience
Gerald Kodjo Q. Aka NovaTheMachine Lead Solidity / Front-end Alchemix Loan to card , BlazerJob NPM package Nova - Google Docs

5. Technical Details

  • Standards – ERC-20 $SAND + EIP-2612 .
  • Contract – PaymentGateway .
  • Infra – Alchemy RPC, Node/Express webhook, Storybook docs.
  • Sandbox tie-in – Same button can power in-world shops via an iframe.

6. Budget & Work Plan

Category Days Amount (USD)
Solidity & tests 15 4 500
React SDK 10 3 000
Webhook & docs 3 900
External audit — 3 000
PM / buffer 15 % — 2 435
Total 28 14 835 USD

Milestones

# Deliverable ETA Budget release
1 Test-net contract + unit tests W 3 25 %
2 npm package v0.1 + Next.js demo W 5 35 %
3 Audit fixes + main-net deploy W 6 40 %

7. DAO Alignment & KPIs

  • Decentralisation – single audited gateway, open-source repo.
  • Creator empowerment – any streamer or shop can accept $SAND instantly.
  • Interoperability – works on every EVM chain.
  • KPIs – tx count & total $SAND through gateway, npm installs, unique integrators.

Discovery: Heard about the Sandbox DAO Grants via Questbook.

2

Hi NovaTheMachine,

It’s not clear to me how your solution works. Could you please provide many more details about it, and share information such as your portfolio, social media, and LinkedIn to verify your experience?

Regards,

3

Detailed Proposal for Pay with $SAND

Hi Yuelwolf, thank you for reviewing my application.
Below you’ll find a deeper dive into how the solution works, plus my professional background and public links for verification.

4

(post deleted by author)

5

(post deleted by author)

6

Hello @NovaTheMachine

Please edit the original post so we have the project more organized and don’t create a new post for each update. Tag me once you’ve made the changes. The way you’re presenting the information is confusing to me, as I see two different portfolios and people. Additionally, the proposal is still unclear. You’re talking about a one-year roadmap with integrations across a large number of ecosystems, which doesn’t align with the milestones in the initial proposal. I need a clear roadmap and corresponding milestones so we can evaluate the proposal.

7

Hello @yuelwolf

NovaTheMachine is simply my dev handle , my real name, Gérald , is on the GitHub and LinkedIn , so it should be clear we’re talking about one person.

The forum is limited to two links, so i used a google drive.
As for the timeline, the one-year roadmap was explicitly labelled “future vision”; the grant request itself is limited to the three six-week milestones .