Admin API 문서

Base URL

https://flutterdev.online/api

인증

현재 인증 없이 사용 가능 (내부 네트워크 전용)

---

Health Check

GET /health

서버 및 블록체인 연결 상태 확인

Response:

{
  "status": "ok",
  "blockNumber": 12345
}

---

Wallets

GET /wallets

모든 지갑 목록 조회

Response:

[
  {
    "id": 1,
    "name": "Main Wallet",
    "address": "0x...",
    "balance": "1000000000.0",
    "created_at": "2024-01-01T00:00:00.000Z"
  }
]

GET /wallets/:id

단일 지갑 상세 조회 (Private Key 포함)

Response:

{
  "id": 1,
  "name": "Main Wallet",
  "address": "0x...",
  "private_key": "0x...",
  "balance": "1000000000.0",
  "created_at": "2024-01-01T00:00:00.000Z"
}

POST /wallets

새 지갑 생성

Request:

{
  "name": "My Wallet"
}

Response:

{
  "id": 2,
  "name": "My Wallet",
  "address": "0x...",
  "private_key": "0x...",
  "balance": "0",
  "mnemonic": "word1 word2 ... word12"
}

POST /wallets/import

기존 지갑 가져오기

Request:

{
  "name": "Imported Wallet",
  "privateKey": "0x..."
}

Response:

{
  "id": 3,
  "name": "Imported Wallet",
  "address": "0x...",
  "balance": "100.0"
}

DELETE /wallets/:id

지갑 삭제

Response:

{
  "success": true
}

---

Balance

GET /balance/:address

주소의 ETH 잔액 조회

Response:

{
  "address": "0x...",
  "balance": "100.5",
  "wei": "100500000000000000000"
}

---

Transactions

GET /transactions

트랜잭션 기록 조회 (최근 100개)

Response:

[
  {
    "id": 1,
    "tx_hash": "0x...",
    "from_address": "0x...",
    "to_address": "0x...",
    "amount": "1.0",
    "status": "confirmed",
    "block_number": 12345,
    "created_at": "2024-01-01T00:00:00.000Z"
  }
]

POST /send

지갑 ID를 사용하여 ETH 전송

Request:

{
  "fromWalletId": 1,
  "toAddress": "0x...",
  "amount": "1.5"
}

Response:

{
  "hash": "0x...",
  "from": "0x...",
  "to": "0x...",
  "amount": "1.5",
  "status": "pending"
}

POST /send-direct

Private Key를 직접 사용하여 ETH 전송

Request:

{
  "privateKey": "0x...",
  "toAddress": "0x...",
  "amount": "1.0"
}

Response:

{
  "hash": "0x...",
  "from": "0x...",
  "to": "0x...",
  "amount": "1.0",
  "status": "confirmed",
  "blockNumber": 12346
}

---

Network

GET /network

네트워크 정보 조회

Response:

{
  "chainId": "3151908",
  "blockNumber": 12345,
  "gasPrice": "0.000000001"
}

---

Server Status

GET /server-status

서버 시스템 상태 조회

Response:

{
  "disks": [
    {
      "filesystem": "/dev/vda1",
      "size": "50G",
      "used": "25G",
      "available": "25G",
      "usePercent": 50,
      "mountPoint": "/"
    }
  ],
  "memory": {
    "total": "16G",
    "used": "8G",
    "free": "4G",
    "available": "8G"
  },
  "dockerContainers": 10,
  "uptime": "5d 12h 30m",
  "timestamp": "2024-01-01T12:00:00.000Z"
}

---

오류 응답

모든 API는 오류 시 다음 형식으로 응답:

{
  "error": "Error message here"
}

HTTP 상태 코드:

• 400: Bad Request (잘못된 요청)
• 404: Not Found (리소스 없음)
• 500: Internal Server Error (서버 오류)

---

예제

curl

# 지갑 목록 조회
curl https://flutterdev.online/api/wallets

# 새 지갑 생성
curl -X POST https://flutterdev.online/api/wallets \
  -H "Content-Type: application/json" \
  -d '{"name": "Test Wallet"}'

# ETH 전송
curl -X POST https://flutterdev.online/api/send \
  -H "Content-Type: application/json" \
  -d '{"fromWalletId": 1, "toAddress": "0x...", "amount": "0.1"}'

JavaScript (fetch)

// 지갑 목록 조회
const wallets = await fetch('https://flutterdev.online/api/wallets')
  .then(res => res.json());

// ETH 전송
const result = await fetch('https://flutterdev.online/api/send', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    fromWalletId: 1,
    toAddress: '0x...',
    amount: '1.0'
  })
}).then(res => res.json());

Python (requests)

import requests

# 지갑 목록 조회
wallets = requests.get('https://flutterdev.online/api/wallets').json()

# ETH 전송
result = requests.post('https://flutterdev.online/api/send', json={
    'fromWalletId': 1,
    'toAddress': '0x...',
    'amount': '1.0'
}).json()