Skip to main content

Sandbox Environment

Verse provides a full sandbox environment for testing integrations, minting on testnets, and validating release flows without using real funds.

Sandbox URLs​

ServiceURL
Marketplacedemo.verse.works
Creator Studiodemo.verse.works/studio
GraphQL APIhttps://demo.verse.works/query
Verse Frame base URLhttps://iframe.demo.verse.works
Verse Elements originhttps://iframe.demo.verse.works

Getting Started​

1. Create a Sandbox Account​

Sign up at demo.verse.works using your email. This is a separate account from your production Verse account.

2. Set Up a Wallet​

Connect a testnet wallet. Supported options:

  • MetaMask configured for Sepolia testnet
  • Any WalletConnect-compatible wallet on testnets

3. Get Testnet Tokens​

You'll need testnet ETH for gas fees. Get free testnet ETH from faucets:

Stripe Sandbox Payments​

The sandbox uses Stripe's test mode for fiat payments. Use these test cards:

Card NumberDescription
4242 4242 4242 4242Successful payment
4000 0000 0000 32203D Secure authentication required
4000 0000 0000 9995Payment declined

For all test cards:

  • Use any future expiration date (e.g., 12/34)
  • Use any 3-digit CVC (e.g., 123)
  • Use any billing postal code
tip

Refer to the Stripe testing documentation for the full list of test cards and scenarios.

Testing Workflows​

Test a Verse Frame Integration​

Point your Verse Frame to the sandbox:

<div verse-series-slug="your-test-collection"></div>

<script>
const verseEmbed = new VerseEmbed({
baseUrl: "https://iframe.demo.verse.works"
});
verseEmbed.initialize();
</script>

Test GraphQL API Queries​

Use the sandbox API endpoint:

curl -X POST https://demo.verse.works/query \
-H "Content-Type: application/json" \
-d '{
"query": "{ collectionsPage(request: { first: 5 }) { nodes { name slug } } }"
}'

Test Verse Elements​

Point Elements to the sandbox origin:

const elements = new VerseElements({
baseUrl: "https://iframe.demo.verse.works",
});

Test a Full Release​

  1. Go to demo.verse.works/studio
  2. Create a new project with your artwork
  3. Deploy a smart contract on testnet
  4. Configure sale mechanics
  5. Run a test sale using testnet ETH or Stripe test cards
  6. Verify the editions are minted correctly

Sandbox vs. Production​

AspectSandboxProduction
URLdemo.verse.worksverse.works
BlockchainTestnet (Sepolia)Ethereum mainnet
PaymentsStripe test modeReal payments
DataTest data, may be resetPermanent
AccountsSeparate from productionProduction accounts
Origin allowlistNot required — works from any domainRequired — localhost:3000 allowlisted by default, contact Verse team for other domains

Important Notes​

  • Sandbox data may be periodically reset — don't rely on it for long-term storage
  • Smart contracts deployed on testnet have no real value
  • The sandbox mirrors production features but may lag behind on the latest updates
  • API schemas are identical between sandbox and production