Full lesson
seloongmun
Se Loong Mun
What it does
From the project README:
You can use any normal anchor commands. Either move to the `anchor` directory and run the `anchor` command or prefix the command with `npm run`, eg: `npm run anchor`.
- Original
- khtang-7777/seloongmun
- SuperStack fork
- Blockchains/seloongmun @
e314413 - Stars
- 0
- Last push (original)
- 2024-04-07
- Languages
- TypeScript, Rust, JavaScript, CSS
- Detected stack
- AnchorNext.jsweb3.js
- Categories
- Other
- Licence
- MIT
Architecture
34 source files. By extension: .tsx ×20, .ts ×9, .js ×4, .rs ×1.
| Top-level directory | Source files |
|---|---|
web | 26 |
anchor | 6 |
(root) | 2 |
On-chain programs: anchor/programs/seloongmun
❌ Does not build as-is, checked 2026-11-02 Tested on 2026-11-02: full log results.json
Build it yourself: step-by-step guide
Every command below was run on 2026-11-02 by tests/run_fork.py against the pinned commit, and the results come from that run. The full output is in the committed log.
1. Prerequisites (versions we tested with)
- Rust:
rustc 1.99.1 (58cf8f9c3 2026-10-13) - Solana CLI (Agave):
solana-cli 1.18.17 (src:c027cfc3; feat:4215500110, client:Agave) - Anchor (via avm):
0.29.0 - Node.js:
v24.22.1 - npm:
11.21.1 - pnpm:
10.34.6
cargo install --git https://github.com/coral-xyz/anchor avm --locked
avm install 0.29.0 && avm use 0.29.0
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"2. Clone at the tested commit
git clone https://github.com/Blockchains/seloongmun.git && cd seloongmun
git checkout e3144132664c173861bd8a3797eaaa34610cddad3. Configure
No environment file is needed.
4. Install dependencies
| Directory | Command | Result | Time |
|---|---|---|---|
. | npm install --no-audit --no-fund --legacy-peer-deps | ✅ pass | 12s |
anchor | npm install --no-audit --no-fund --legacy-peer-deps | ✅ pass | 2s |
anchor | npm install --no-audit --no-fund --legacy-peer-deps | ✅ pass | 0s |
5. Build
| Directory | Command | Result | Time |
|---|---|---|---|
anchor | anchor@0.29.0 build | ✅ pass | 68s |
. | npm run build | ❌ exit 1 | 21s |
Output tail: npm run build
[0m [90m | [39m [31m[1m^[22m[39m[0m
[0m [90m 4 | [39m[36mimport[39m { [33mProgram[39m } [36mfrom[39m [32m'@coral-xyz/anchor'[39m[33m;[39m[0m
[0m [90m 5 | [39m[36mimport[39m { useConnection } [36mfrom[39m [32m'@solana/wallet-adapter-react'[39m[33m;[39m[0m
[0m [90m 6 | [39m[36mimport[39m { [33mCluster[39m[33m,[39m [33mKeypair[39m[33m,[39m [33mPublicKey[39m } [36mfrom[39m [32m'@solana/web3.js'[39m[33m;[39m[0m
Error occurred while trying to run the build command
16. Test
| Directory | Command | Result | Time |
|---|---|---|---|
anchor | anchor@0.29.0 test --skip-build --provider.cluster localnet --provider.wallet ~/.config/solana/id.json | ✅ pass | 8s |
7. Deploy to a local validator
solana-test-validator --reset # separate terminal
solana config set -ul && solana airdrop 100
anchor deploy --provider.cluster localnet| Directory | Command | Result | Time |
|---|---|---|---|
anchor | solana airdrop 100 -u localhost >/dev/null; anchor@0.29.0 deploy --provider.cluster localnet --provider.wallet ~/.config/solana/id.json | ✅ pass | 5s |
Proof: program IDs and transactions
seloongmun:A6565D1zQG8aqg3z2sNGTr8F89scCWGLJRsPq3YBEXfr(local validator)
Transaction signatures recorded on the local validator (1 shown). Local ledgers are thrown away after the run, so these work as receipts in the log and can't be looked up on an explorer:
seloongmun5excrsC2rvLdBGekGNNb…pnBzTuvF
Deploy to devnet (free)
solana config set --url devnet
solana airdrop 2 # or https://faucet.solana.com
anchor deploy --provider.cluster devnet # native: solana program deploy target/deploy/<name>.so
# point the frontend RPC env var at https://api.devnet.solana.comHow it works
Every instruction handler in the program, with the accounts struct it validates. Each link points to the line at the pinned commit.
| Instruction | Accounts | Where |
|---|---|---|
initialize | Initialize | anchor/programs/seloongmun/src/lib.rs:17 |
draw | Draw | anchor/programs/seloongmun/src/lib.rs:38 |
Extend it
- Add an integration test that runs the main flow end to end and asserts every account state change.
- Add a negative test: call each instruction with the wrong signer or account and check that it fails.
- Add an event (
emit!) to each state-changing instruction and subscribe to it from the client. - Replace any unchecked
AccountInfowith typed accounts plushas_one/seedsconstraints. - Make the frontend read the cluster from an env var, deploy it to GitHub Pages and point it at your devnet program.
- Wire the build into CI by copying this site's verify-forks workflow.
Open the dapp
Deployed on devnet; the full in-browser flow is not yet proven end to end.
Open the dapp Connect Phantom or Solflare. Every transaction is signed in your own wallet.
- Devnet (test tokens): program
A6565D1zQG8aqg3z2sNGTr8F89scCWGLJRsPq3YBEXfr. Get free devnet SOL at faucet.solana.com. - Mainnet: not yet deployed on mainnet (needs owner approval), so it is disabled
Key code, explained
Excerpts chosen automatically where the code uses the most Solana concepts, pinned to the fork's commit.
anchor/programs/seloongmun/src/lib.rs L97–119 @ e314413 · MIT · original #[derive(Accounts)]pub struct Initialize<'info> { #[account( init_if_needed, payer = signer, space = 8 + 9, seeds = [b"safevault"], bump, )] pub safe_vault: Account<'info, SafeVault>, #[account( init_if_needed, payer = signer, space = 8 + 11, seeds = [b"seloongmun"], bump, )] pub seloongmun: Account<'info, Seloongmun>, #[account(mut)] pub signer: Signer<'info>, pub system_program: Program<'info, System>,}- Line 101
init_if_needed,: Creates the account only if it doesn't exist. Watch for re-initialisation bugs. - Line 104
seeds = [b"safevault"],: Declares the PDA seeds. Anchor re-derives the address and rejects the account if it doesn't match. - Line 105
bump,: Uses the bump seed, the extra byte that pushes the derived address off the ed25519 curve. - Line 117
pub signer: Signer<'info>,: Requires this account to have signed the transaction.
How to run, build and test
These commands come from the repo's own manifests (package.json scripts, Anchor.toml, Cargo, go.mod, Makefile). Check the README for prerequisites and environment variables.
| Directory | Command | Runs |
|---|---|---|
. | npm run dev | nx serve web |
. | npm run build | nx build web |
anchor | anchor build | compile programs and generate IDLs |
anchor | anchor test | local validator + test suite |
anchor | anchor run test | ../node_modules/.bin/nx run anchor:jest |
What you could build from it
- Fork the SuperStack copy and extend it within the Other gaps listed on the idea page.
- Learn the pattern first: Program Derived Addresses (PDAs)
- Learn the pattern first: Cross-Program Invocations (CPIs)