Skip to content

FAQ.md

Latest commit

 

History

History
367 lines (217 loc) · 5.15 KB

FAQ.md

File metadata and controls

367 lines (217 loc) · 5.15 KB
Raw

FAQ

Frequently Asked Questions for the Stellar Bounty Board project.

1. How do I get testnet XLM?

You can fund your Stellar testnet account using Friendbot.

Option 1 — Browser

Open:

https://friendbot.stellar.org/?addr=YOUR_PUBLIC_KEY

Replace YOUR_PUBLIC_KEY with your Stellar testnet wallet address.

Option 2 — cURL

curl "https://friendbot.stellar.org/?addr=YOUR_PUBLIC_KEY"

Verify Funding

Use Stellar Laboratory or Freighter to confirm your balance.

Useful resources:

2. How do I set up Freighter wallet?

  1. Install Freighter extension:

  2. Create or import a wallet.

  3. Switch network to Testnet.

  4. Fund the wallet using Friendbot.

  5. Connect wallet to the app.

Common Issue

If the wallet does not connect:

  • Refresh the page
  • Unlock Freighter
  • Ensure you are on Testnet
  • Reconnect wallet permissions

3. Why is my signature rejected?

This usually happens because:

  • Wrong network selected
  • Expired transaction
  • Invalid secret/public key pair
  • Incorrect signing payload
  • Wallet disconnected

Fixes

Verify Network

Ensure both:

  • Wallet = Testnet
  • App = Testnet

Reconnect Wallet

Disconnect and reconnect Freighter.

Regenerate Signature

Create a fresh transaction payload and sign again.

Check Expiration

If the transaction expired, regenerate it before signing.

4. How do I reset the bounty store?

The project may use local storage, indexed storage, or backend persistence for bounty state.

Frontend Reset

Clear browser storage:

localStorage.clear()

or clear site data from browser settings.

Development Database Reset

If using Docker:

docker compose down -v
docker compose up

If using SQLite/Postgres, rerun migrations or reseed scripts.

5. How do I configure the expiration job?

Some bounties automatically expire after a configured duration.

Typical Environment Variables

EXPIRATION_JOB_INTERVAL=60
BOUNTY_EXPIRATION_HOURS=24

Running Cron/Worker

Example:

npm run worker

or

npm run cron

depending on project scripts.

Verify Expiration Logic

Check:

  • Backend logs
  • Scheduled job startup
  • Database timestamps

6. Why are transactions failing?

Common causes include:

  • Insufficient XLM balance
  • Incorrect network
  • Invalid contract ID
  • Expired transaction
  • RPC failure
  • Bad signature

Troubleshooting Steps

Check Wallet Balance

Ensure your account has enough testnet XLM.

Verify Contract Address

Double-check deployed contract IDs.

Retry Transaction

Temporary RPC/network issues can occur.

Inspect Logs

Backend logs usually provide exact failure details.

7. How does the dispute flow work?

The dispute system is designed to resolve bounty disagreements fairly.

Typical Flow

  1. Contributor submits work
  2. Sponsor reviews submission
  3. Sponsor approves or disputes
  4. Admin/moderator may intervene
  5. Funds are released or refunded

Best Practices

  • Include detailed submissions
  • Attach screenshots or hashes
  • Maintain communication records

8. How do I run the project locally?

Install Dependencies

npm install

Configure Environment

Create:

.env

and add required variables.

Start Development Server

npm run dev

Backend (if applicable)

npm run backend

or:

docker compose up

9. How do I run tests?

Run All Tests

npm test

Run Specific Tests

npm run test:unit
npm run test:integration

Smart Contract Tests

cargo test

if Soroban contracts are included.

10. Why is my wallet not connecting?

Possible Causes

  • Freighter locked
  • Browser permissions denied
  • Wrong network
  • Unsupported browser
  • Extension conflict

Solutions

Unlock Freighter

Open extension and unlock it.

Reconnect Permissions

Remove site permissions and reconnect.

Refresh Browser

Reload app after wallet unlock.

Supported Browsers

Recommended:

  • Chrome
  • Brave
  • Edge

11. How do I deploy contracts to Stellar testnet?

Build Contract

cargo build --target wasm32-unknown-unknown --release

Deploy

soroban contract deploy \
  --wasm target/wasm32-unknown-unknown/release/contract.wasm \
  --source alice \
  --network testnet

Verify Deployment

Use Stellar Laboratory or explorer tools.

12. Where can I find logs for debugging?

Frontend Logs

Open browser DevTools:

F12 → Console

Backend Logs

Run server in development mode:

npm run dev

or inspect Docker logs:

docker compose logs -f

Contract Logs

Use Soroban CLI simulation tools and RPC responses.

Additional Resources

Contributing

Please also review:

  • README.md
  • CONTRIBUTING.md

before submitting issues or pull requests.