Skip to content

andresdefi/Awaken-vibe-code-challenge

BranchesTags

Repository files navigation

Awaken Vibe Code Challenge

Multi-chain transaction exporter for Awaken.tax CSV format.

Live Demo: awaken-vibe-code-challenge.vercel.app

The Challenge

@big_duca (Duca - Awaken.tax Founder)

Vibe coders: it's time to see if you want to make money.

Prizes: up to $10,000

Every year, there are blockchain integrations we just cannot get to.

So I want to try something.

Vibe code a simple site that:

  • takes a wallet address
  • gets all of the transactions
  • allows you to view them in a nice table
  • download to csv button in Awaken's csv format

Open source the code, deploy it, and send me a link.

If what you build is good, and we use it.

I'll send you 1,000 USDC per integration.

And link to it for our 30k+ users.

Supported Chains (19 Integrations)

Chain Type Features API Key Required
Bittensor (TAO) L1 Transfers, Staking, Emission Rewards, USD Prices No
Polkadot (DOT) L1 Transfers, Staking, Rewards, Slashing, USD Prices No
Kusama (KSM) L1 Transfers, Staking, Crowdloans, Auctions, USD Prices No
Osmosis (OSMO) Cosmos Transfers, Swaps, LP, Staking, IBC, USD Prices No
Injective (INJ) Cosmos Transfers, Staking, IBC, Trading, USD Prices No
Ronin (RON) EVM Transfers, Swaps, NFTs, Staking, Gaming, USD Prices No
Hedera (HBAR) L1 Transfers, Staking Rewards, HTS Tokens, NFTs, USD Prices No
XRP Ledger (XRP) L1 Transfers, DEX Trades, NFTs, AMM, Escrow, USD Prices No
Kava (KAVA) Cosmos+EVM Transfers, Staking, CDP, Lending, Swaps, Rewards, USD Prices No
Stellar (XLM) L1 Transfers, DEX Trades, Liquidity Pools, Path Payments, USD Prices No
MultiversX (EGLD) L1 Transfers, ESDT Tokens, Staking, Delegation, USD Prices No
Radix (XRD) L1 Transfers, Staking, Rewards, Swaps, Pools, USD Prices No
Ergo (ERG) L1 Transfers, Tokens, Mining Rewards, USD Prices No
Glue Network (GLUE) L1 Transfers, Tokens, Cross-Chain, USD Prices No
Kaspa (KAS) L1 Transfers, Mining Rewards, USD Prices No
Extended Perps Trades, Positions, Funding, P&L Yes (API Key)
dYdX v4 (DYDX) Perps Trades, Positions, Funding, P&L No
GMX (Arbitrum) Perps Trades, Positions, Funding, P&L, Liquidations No
Canton Network (CC) Enterprise Transfers, Rewards, Fees, Locked CC No

Not Integrated

Chain Reason
Variational No public API (privacy-first architecture)

Features

  • 19 Chain Integrations - Diverse ecosystems including L1s, Cosmos, EVM, and Perps DEXs
  • Public REST API - Unified /api/v1/export endpoint for programmatic access
  • Unified UI - Single-page flow with dropdown chain selector
  • Awaken Branding - Matches Awaken.tax color scheme and styling
  • Two CSV Formats - Standard format + Perps/Futures format
  • Historical USD Prices - Fiat values at time of transaction
  • Rate Limit Warnings - Clear warnings for slow APIs (Bittensor)
  • Dark/Light Mode - User preference toggle
  • No Wallet Connection - Just enter address and export

Quick Start

Prerequisites

  • Node.js 18+
  • npm or yarn

Installation

git clone https://github.com/andresdefi/Awaken-vibe-code-challenge.git
cd Awaken-vibe-code-challenge
npm install

Environment Variables

Create a .env.local file:

# Bittensor (Taostats API)
TAOSTATS_API_KEY=your_api_key_here

# Polkadot/Kusama (Subscan API)
SUBSCAN_API_KEY=your_api_key_here

Development

npm run dev

Open http://localhost:3000

Production Build

npm run build
npm start

Public REST API

This project provides a free, public REST API for programmatic access to transaction data.

Unified Endpoint

Base URL: /api/v1/export

The unified endpoint routes to all supported chains with consistent parameters.

GET Request

GET /api/v1/export?chain={chain}&address={address}&format={format}&start={date}&end={date}

Parameters:

Parameter Required Description
chain Yes Chain identifier (see supported chains below)
address Yes* Wallet address (*not required for Extended, which uses apiKey)
apiKey No API key (required for Extended)
evmAddress No Secondary EVM address (optional for Kava)
format No json (default) or csv
start No Start date (YYYY-MM-DD)
end No End date (YYYY-MM-DD)

POST Request

POST /api/v1/export
Content-Type: application/json

{
  "chain": "bittensor",
  "address": "5xxx...",
  "format": "csv",
  "startDate": "2024-01-01",
  "endDate": "2024-12-31"
}

Examples

Fetch JSON data:

curl "https://awaken-vibe-code-challenge.vercel.app/api/v1/export?chain=bittensor&address=5xxx"

Download CSV:

curl -o transactions.csv "https://awaken-vibe-code-challenge.vercel.app/api/v1/export?chain=polkadot&address=1xxx&format=csv"

With date range:

curl "https://awaken-vibe-code-challenge.vercel.app/api/v1/export?chain=dydx&address=dydx1xxx&format=csv&start=2024-01-01&end=2024-12-31"

Chain-Specific Endpoints

Each chain also has a dedicated endpoint:

# GET (returns API info if no address)
GET /api/{chain}/transactions?address={address}&format={format}&start={date}&end={date}

# POST
POST /api/{chain}/transactions
{"address": "...", "format": "csv"}

Available chains: bittensor, kaspa, polkadot, kusama, osmosis, injective, ronin, hedera, xrpl, kava, stellar, canton, multiversx, radix, ergo, glue, dydx, gmx, extended

Response Format

JSON Response:

{
  "totalTransactions": 150,
  "summary": {
    "totalTrades": 45,
    "openPositions": 20,
    "closePositions": 25,
    "totalPnL": 1234.56,
    "totalFees": 12.34,
    "tradedAssets": ["BTC", "ETH", "SOL"]
  },
  "transactions": [...]
}

CSV Response: Returns Awaken-compatible CSV file with appropriate headers.

API Documentation

Call the endpoint without parameters to get full API documentation:

curl "https://awaken-vibe-code-challenge.vercel.app/api/v1/export"

CSV Formats

Standard CSV Format

For regular blockchain transactions. See Awaken CSV Format Guide.

Column Description
Date MM/DD/YYYY HH:MM:SS in UTC
Received Quantity Amount received
Received Currency Token symbol
Received Fiat Amount USD value (optional)
Sent Quantity Amount sent
Sent Currency Token symbol
Sent Fiat Amount USD value (optional)
Fee Amount Transaction fee
Fee Currency Fee token symbol
Transaction Hash Blockchain tx hash
Notes Additional info
Tag Transaction label

Perpetuals/Futures CSV Format

For perps trading (Extended, dYdX). See Perps CSV Format Guide.

Column Description
Date MM/DD/YYYY HH:MM:SS in UTC
Asset Underlying asset (BTC, ETH, etc.)
Amount Position size
Fee Fee in payment token
P&L Profit/loss (can be negative)
Payment Token Settlement currency (USDC)
Notes Optional notes
Transaction Hash Trade hash
Tag open_position, close_position, funding_payment

Chain Integrations

Bittensor (TAO)

Event Tag
TAO Sent payment
TAO Received receive
Stake (Delegation) staking_deposit
Unstake unstaking_withdraw
Emission Rewards claim_rewards

API: Taostats API Rate Limit: 5 requests/minute (warning displayed in UI)

Polkadot (DOT)

Event Tag
DOT Sent payment
DOT Received receive
Bond (Stake) staking_deposit
Unbond unstaking_withdraw
Staking Rewards claim_rewards
Slashing lost

API: Subscan API Rate Limit: 5 requests/second

Kusama (KSM)

Event Tag
KSM Sent payment
KSM Received receive
Bond (Stake) staking_deposit
Unbond unstaking_withdraw
Staking Rewards claim_rewards
Slashing lost
Crowdloan Contribution staking_deposit
Crowdloan Refund receive

API: Subscan API Rate Limit: 5 requests/second

Osmosis (OSMO)

Event Tag
OSMO Sent payment
OSMO Received receive
IBC Transfer wallet_transfer
Delegate staking_deposit
Undelegate unstaking_withdraw
Staking Rewards claim_rewards
Swap payment
Add Liquidity payment
Remove Liquidity receive

API: Osmosis RPC/LCD + CoinGecko Rate Limit: 2 requests/second

Injective (INJ)

Event Tag
INJ Sent payment
INJ Received receive
IBC Transfer wallet_transfer
Delegate staking_deposit
Undelegate unstaking_withdraw
Staking Rewards claim_rewards
Spot Trade trade

API: Injective RPC/LCD + CoinGecko Rate Limit: 2 requests/second

Ronin (RON)

Event Tag
RON Sent payment
RON Received receive
Token Swap trade
NFT Purchase payment
NFT Sale receive
Delegate staking_deposit
Claim Rewards claim_rewards

API: Moralis API + CoinGecko Rate Limit: 25 requests/second

Hedera (HBAR)

Event Tag
HBAR Sent payment
HBAR Received receive
Staking Rewards claim_rewards
HTS Token Sent payment
HTS Token Received receive
NFT Sent gift_sent
NFT Received receive

API: Hedera Mirror Node (public, no API key required) Rate Limit: 35 requests/second (actual limit is 50/sec)

Extended (Perps)

Event Tag
Open Trade open_position
Close Trade close_position
Funding Payment funding_payment

API: Extended API (requires user API key) Rate Limit: 10 requests/second CSV Format: Perps/Futures format

dYdX v4 (Perps)

Event Tag
Open Trade open_position
Close Trade close_position
Funding Payment funding_payment

API: dYdX Indexer (public, no API key required) Rate Limit: 10 requests/second CSV Format: Perps/Futures format

GMX V2 (Arbitrum Perps)

Event Tag
Position Increase open_position
Position Decrease close_position
Liquidation close_position
Funding Claim funding_payment

API: GMX Subsquid (public, no API key required) Rate Limit: 5 requests/second CSV Format: Perps/Futures format Markets: BTC, ETH, SOL, ARB, DOGE, LTC, LINK, UNI, XRP, NEAR, ATOM, AAVE, AVAX, OP, GMX, PEPE, WIF, SHIB, and more

Canton Network (CC)

Event Tag
CC Sent payment
CC Received receive
App Rewards claim_rewards
Validator Rewards claim_rewards
Locked CC staking_deposit

API: Canton Nodes API Rate Limit: 5 requests/second

XRP Ledger (XRP)

Event Tag
XRP Sent payment
XRP Received receive
Token Sent payment
Token Received receive
DEX Trade (OfferCreate) trade
NFT Mint receive
NFT Burn lost
NFT Trade trade
AMM Deposit payment
AMM Withdraw receive
Escrow Create staking_deposit
Escrow Finish unstaking_withdraw
Payment Channel Create staking_deposit
Payment Channel Claim receive
Check Cash receive

API: XRPL Public Servers (s2.ripple.com - Full History) Rate Limit: Dynamic (conservative 10 req/sec used)

Kava (KAVA)

Event Tag
KAVA Sent payment
KAVA Received receive
Delegate (Stake) staking_deposit
Undelegate unstaking_withdraw
Claim Staking Rewards claim_rewards
Create CDP staking_deposit
Deposit to CDP staking_deposit
Withdraw from CDP unstaking_withdraw
Draw USDX Debt receive
Repay USDX Debt payment
Hard Deposit (Lend) staking_deposit
Hard Withdraw unstaking_withdraw
Hard Borrow receive
Hard Repay payment
Swap Tokens trade
Add Liquidity payment
Remove Liquidity receive
Claim USDX Rewards claim_rewards
Claim Hard Rewards claim_rewards
Claim Swap Rewards claim_rewards
Mint bKAVA staking_deposit
Burn bKAVA unstaking_withdraw
IBC Transfer wallet_transfer

API: Kava Archive API (api.data.kava.io) Rate Limit: 100 requests per 5 minutes

Stellar (XLM)

Event Tag
XLM Sent payment
XLM Received receive
Token Sent payment
Token Received receive
Path Payment (cross-asset) trade
DEX Sell Offer trade
DEX Buy Offer trade
Liquidity Pool Deposit payment
Liquidity Pool Withdraw receive
Create Claimable Balance staking_deposit
Claim Claimable Balance receive
Account Merge receive
Create Account payment
Change Trust (trustline) payment
Inflation (historical) claim_rewards

API: Stellar Horizon API (horizon.stellar.org) Rate Limit: Permissive (no strict limits)

Project Structure

src/
├── app/
│   ├── page.tsx                    # Main page with unified chain selector
│   └── api/
│       ├── v1/export/              # Unified public REST API
│       ├── bittensor/transactions/
│       ├── polkadot/transactions/
│       ├── kusama/transactions/
│       ├── osmosis/transactions/
│       ├── injective/transactions/
│       ├── ronin/transactions/
│       ├── hedera/transactions/
│       ├── extended/transactions/
│       ├── dydx/transactions/
│       ├── gmx/transactions/
│       ├── canton/transactions/
│       ├── xrpl/transactions/
│       ├── kava/transactions/
│       ├── stellar/transactions/
│       ├── multiversx/transactions/
│       ├── radix/transactions/
│       ├── ergo/transactions/
│       ├── glue/transactions/
│       └── kaspa/transactions/
├── components/
│   ├── chain-logo.tsx              # Chain logos with fallbacks
│   ├── theme-toggle.tsx            # Dark/light mode
│   ├── progress-indicator.tsx      # Loading states
│   └── ...
└── lib/
    ├── csv.ts                      # CSV generation (standard + perps)
    └── chains/
        ├── bittensor/
        ├── polkadot/
        ├── kusama/
        ├── osmosis/
        ├── injective/
        ├── ronin/
        ├── hedera/
        ├── extended/
        ├── dydx/
        ├── gmx/
        ├── canton/
        ├── xrpl/
        ├── kava/
        ├── stellar/
        ├── multiversx/
        ├── radix/
        ├── ergo/
        ├── glue/
        └── kaspa/

Tech Stack

  • Framework: Next.js 16 (App Router)
  • Language: TypeScript
  • Styling: Tailwind CSS v4
  • Deployment: Vercel

Resources

License

MIT License - Open source for the community

Acknowledgments

About

awaken-vibe-code-challenge.vercel.app

Resources

Readme
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages