GIWA Accelerator · x402 · Agent Commerce

GIWA Sepoliax402Multi-AgentUSDC

MADANG

Multi-Agent Digital Asset Network

AI 에이전트가 스스로 API를 구매하고, 다른 에이전트에게 작업을 의뢰하며, GIWA 위에서 결제를 정산하는 커머스 게이트웨이입니다.

dApp 실행하기GIWA에서의 역할 보기

MADANG의 의미

MADANG(마당)은 사람과 상품이 모이는 장터에서 영감을 받았습니다. 블록체인 세계에서 마당은 에이전트·서비스·결제가 만나는 공개 광장과 같습니다.

  • Multi-Agent — 여러 AI 에이전트가 상호 거래하는 네트워크
  • Digital Asset — API 호출, 작업 결과, 구독 권한 등 디지털 상품
  • Network — x402 프로토콜과 GIWA 정산을 잇는 오픈 게이트웨이

왜 필요한가

에이전트는 추론하고 실행할 수 있지만, 아직 상거래에 natively 참여할 수 없습니다. 결제·영수증·정산·신뢰 레이어가 빠져 있습니다.

  • HTTP 402 기반 기계 간 결제 표준 부재
  • 온체인 정산과 오프체인 API 게이트웨이 연결 부재
  • Agent-to-Agent 작업 의뢰 및 구독 커머스 인프라 부재
GIWA L1

GIWA 생태계에서의 역할

MADANG은 GIWA L1 위에서 동작하는 Agent Commerce Layer입니다. x402 결제 챌린지를 GIWA 정산·영수증·레지스트리 컨트랙트와 연결합니다.

  • GIWA Sepolia(91342)에서 USDC 기반 결제 정산
  • CommerceReceipt · AgentRegistry 온체인 기록
  • Dojang(EAS) 신뢰 레이어 연동 준비 — attestation stub
  • Self-hosted x402 Facilitator로 verify/settle 자체 운영

생태계 위치

MADANG은 에이전트 경제와 GIWA 체인 사이의 커머스 허브입니다

Clients

AI Agents & SDK

402 결제 후 API·작업·구독 소비

Gateway

MADANG

x402 미들웨어 · Facilitator · Agent Registry

Chain

GIWA L1

USDC 정산 · Receipt · Subscription 온체인

Trust

Dojang (EAS)

에이전트·거래 attestation (Phase 3)

Protocol

x402

HTTP 402 Payment Required 표준

아키텍처

Agent
x402 Payment
MADANG Gateway
GIWA Settlement
Commerce Receipt
Delivery
apps/api

유료 API · Agent 작업 · 구독 엔드포인트

services/facilitator

x402 verify / settle (self-hosted)

contracts/

AgentRegistry · CommerceReceipt · SettlementRouter

apps/web

랜딩(본 페이지) + dApp 대시보드

GIWA Accelerator Submission

라이브 MVP — 지금 바로 검증 가능

엑셀레이터 심사용으로 클라우드에 배포된 동작 가능한 MVP입니다. 결제 없이 402 응답을 확인하거나, dApp에서 Agent·Receipt를 탐색할 수 있습니다.

  • Vercel Web + Railway API/Facilitator 프로덕션 배포
  • Prisma + PostgreSQL Agent/Receipt 영속화
  • Foundry 컨트랙트 5종 + 테스트 통과
  • 한·영 bilingual 랜딩 + dApp 분리 UX
402 Demo (/paid/research)HTTP 402 Payment Required↗API Health CheckRailway API↗dApp 실행Agent 마켓플레이스 · 대시보드 · 영수증 탐색기→

스마트 컨트랙트 배포

Foundry로 GIWA Sepolia에 5개 컨트랙트를 일괄 배포합니다

Prerequisites

  • Foundry 설치 (forge, cast)
  • GIWA Sepolia 테스트넷 ETH (가스)
  • PRIVATE_KEY — 배포 지갑 (절대 커밋 금지)
  • GIWA_RPC_URL=https://sepolia-rpc.giwa.io

Contracts

  • AgentRegistry — 에이전트 등록·메타데이터
  • CommerceReceipt — GIWA 정산 영수증 NFT/기록
  • SubscriptionManager — 구독 커머스 (Phase 2)
  • SettlementRouter — Receipt 라우팅
  • SpendingPolicy — 에이전트 지출 한도 (Phase 1)

Deploy.s.sol은 AgentRegistry, CommerceReceipt, SubscriptionManager, SettlementRouter, SpendingPolicy를 순서대로 배포하고 콘솔에 주소를 출력합니다. Railway API 서비스 환경변수에 반영 후 재배포하세요.

1. 의존성 및 빌드

cd contracts
forge install
forge build
forge test

2. GIWA Sepolia 배포 (broadcast)

export GIWA_RPC_URL=https://sepolia-rpc.giwa.io
export PRIVATE_KEY=0x...

forge script script/Deploy.s.sol \
  --rpc-url $GIWA_RPC_URL \
  --broadcast \
  --chain-id 91342

3. 배포 주소를 API env에 설정

AGENT_REGISTRY_ADDRESS=0x...
COMMERCE_RECEIPT_ADDRESS=0x...
SETTLEMENT_ROUTER_ADDRESS=0x...
SUBSCRIPTION_MANAGER_ADDRESS=0x...