Splurge

On-chain e-commerce platform for PRJ3223 Capstone Project 2, Turbin3 Builders Cohort and School of Solana.

Live Website

Program on Solana Explorer

Source Repository

Features

• Manage store listings
• Track and fulfill orders
• Leave product reviews

Built With

Languages

• 
• 
• 

Libraries

• @coral-xyz/anchor
• @solana/web3.js
• @solana/spl-token
• litesvm
• anchor-litesvm
• @dialectlabs/blockchain-sdk-solana
• @dialectlabs/react-sdk-blockchain-solana
• @dialectlabs/react-ui
• @dialectlabs/sdk
• @helium/tuktuk-idls
• @helium/tuktuk-sdk
• @solana/wallet-adapter-react
• @jup-ag/wallet-adapter
• @solana-developers/helpers
• @irys/web-upload
• @pythnetwork/hermes-client
• next
• shadcn/ui
• zod
• swr

Crates

• anchor-lang
• anchor-spl
• num-derive
• num-traits
• pyth-solana-receiver-sdk
• spl-math
• tuktuk-program

Test Runner

• 

Getting Started

Prerequisites

1. Update your Solana CLI, avm and Bun toolkit to the latest version

agave-install init 2.1.0
avm use 0.31.1
bun upgrade

Setup

1. Clone repository

git clone https://github.com/ChiefWoods/splurge.git

2. Configure to use localnet

solana config set -ul

3. In another terminal, start a local validator

solana-test-validator

4. Create and fund keypair

solana-keygen new -o splurge-wallet.json
solana airdrop 10 -k splurge-wallet.json

5. Install dependencies

bun i

6. Configure .env files

cp .env.example .env

Program

1. Resync your program id

anchor keys sync

2. Build program

anchor build
# Alternative build for running tests
# bun run build:test

3. Run tests

bun test

5. Deploy program

anchor deploy

6. Optionally initialize IDL

anchor idl init -f target/idl/splurge.json <PROGRAM_ID>

Sync IDL with App

IDL files in /app may need to be updated on every program build.

bun run idl:sync

Accounts

Initialize program accounts. Depending on the cluster used, you may be required to initialize your own stablecoin mints.

1. Configure .env files

cp .env.example .env

2. Run scripts

bun run scripts/instructions/initializeConfig.ts

Tuktuk Automation

When an order is updated to Shipping status, it is scheduled as a task and will automatically be picked up by Tuktuk crank turners after 1 minute. This eliminates the need for manual order completion.

A public crank turner is relied on to run tasks, but you may optionally set up your own crank turner to ensure tasks don't go stale before being picked up.

bun run tuktuk

Issues

View the open issues for a full list of proposed features and known bugs.

Acknowledgements

Resources

• Shields.io
• USDC Faucet
• PYUSD Faucet

Hosting and API

• Vercel
• Helius
• Dicebear
• Pyth

Contact

chii.yuen@hotmail.com