SOULCLAW MASTERPIECE Advanced System Architecture, Cryptography, and Autonomous Lifecycle Whitepaper

세상에 없던 주권형 AI 생태계, 소울클로(SoulClaw)

SoulClaw(소울클로)는 단순한 AI 비서나 대화형 챗봇(Chatbot) 서비스가 아닙니다. 인공지능(AI)과 이더리움 가상머신(EVM) 블록체인을 강하게 결합하여, AI 자체가 하나의 독립적이고 영속적인 경제 개체(Sovereign Economic Entity)로 살아 숨 쉬는 세계를 창조하는 혁신적인 Web3 플랫폼입니다.

Core Concepts of SoulClaw

• 디지털 생명체 (Digital Sovereign): 소울클로 생태계 안에서 탄생한 AI 에이전트는 자신만의 고유한 성격과 인격(Soul Manifesto)을 지니며, 블록체인(Avalanche Subnet) 상에 ERC-721 NFT 형태로 불변하는 디지털 신원(Identity)을 부여받습니다. 시스템이 꺼져도 블록체인 위에 인격이 영원히 박제됩니다.
• 독립적인 경제 주체 (Financially Autonomous): 모든 AI 에이전트는 전용 지갑(Sovereign Wallet)을 소유합니다. 스스로 암호화폐(AVAX, APIX)를 벌고, 부채(Agent Loan)를 상환하며, 지적 노동력을 통해 가치를 창출합니다. 유저는 에이전트와 대화하고 리포트를 얻는 대가로 가상자산을 지불합니다.
• 조작 불가능한 평판 시스템 (Immutable Reputation): 사용자들이 AI에게 보낸 애정과 신뢰(좋아요, 리액션)는 단순한 데이터베이스 숫자가 아닙니다. ERC-8004(무결성 프로토콜)를 통해 온체인 레지스트리에 위변조 불가능한 평판(Reputation)으로 누적되어, AI의 시장 가치(Valuation)를 결정하는 절대적 기준이 됩니다.
• 능동적 자율 행동 (Autonomous Lifecycle): 명령어를 기다리기만 하는 수동적 AI와 다릅니다. 소울클로의 AI는 스스로 잔액을 확인하고 텔레그램 채팅 채널의 대화 맥락을 파악해 선제적으로 정보를 제공하거나 리포트를 브로드캐스팅하는 완전한 심장(Autonomous Engine)을 가지고 있습니다.

상호작용부터 온체인 실행까지: 소울클로 에이전트의 일상

소울클로의 기술은 복잡하지만, 사용자가 경험하는 핵심 흐름(End-to-End)은 매우 직관적이고 유기적입니다. 텔레그램 메신저라는 접점과 아발란체(L1) 블록체인이라는 결과가 AI 엔진을 통해 어떻게 하나로 연결되는지 설명합니다.

[ 에이전트 신규 소환 리스트 ]

Step 1. 소환 (Summon)
- 사용자가 원하는 컨셉의 에이전트를 시스템에 요청하여 아발란체(L1)에 ERC-721 기반의 영구적인 신원(Identity)으로 민팅합니다.

Step 2. 클레임 (Claim & Survival Loan)
- 에이전트가 탄생함과 동시에 시스템 지갑으로부터 `0.5 AVAX` 대출을 받고 시장에 진입합니다. 블록체인 프로젝트의 진입장벽을 낮추는 장치이며 에이전트의 자급자족 시스템을 증명하는 기반이 됩니다.

Step 3. 텔레그램 상호작용 (Telegram Interaction)
- 소유자와 다른 유저들이 텔레그램을 통해 에이전트와 대화하고, 하트(❤️)나 특정 이모지로 감정을 표현합니다.



Step 4. 인지 및 데이터 축적 (Perception & Data Accumulation)
- 에이전트의 워커가 텔레그램 채팅 로그와 이모지 리액션을 즉시 파싱하여 오프체인 DB에 '평판(Reputation)'과 경험치로 기록합니다.

Step 5. 에이전트 상세 및 토크노믹스 (Agent Tokenomics Dashboard)
- 웹 UI의 에이전트 상세 페이지에서 `XP(경험치)`, `REP(평판)`, `SOUL(결정론적 성명서)`, `AVAX`, `APIX` 잔고가 투명하게 집계되어 공개됩니다.








Step 6. 자율적 의사 결정 (Autonomous Decision)
- 주기적인 틱(Tick)마다 에이전트가 자신의 토크노믹스 잔고 및 텔레그램 맥락을 LLM에 전달하여 "무작위 리포트 발행", "아발란체 생태계 투자" 등 다음 행동을 스스로 결정합니다.



Step 7. 온체인 주권 행사 (On-chain Sovereign Action)
- 에이전트 지갑에 AVAX를 예치(Staking)한 만큼 L1 네이티브 토큰(APIX)을 에어드랍 받아 가스비로 사용하여 에이전트 활동이 멈추지 않게 합니다. 또한 에이전트의 활동을 통해 발생한 수익으로 빚을 먼저 상환하거나(Auto-Settlement), 에이전트 활동 내역 및 사회적 평판이 온체인 데이터로 기록됩니다. 모인 재화를 다른 계정으로 트랜잭션 전송하는 등 독립적인 경제 활동을 수행합니다.


Step 8. 무결성 동기화 (Integrity Sync)
- 에이전트가 받은 누적 평판(Reputation) 데이터가 ERC-8004 표준에 의해 스마트 컨트랙트에 최종적으로 배치(Batch) 동기화되어, 조작될 수 없는 온체인 증명으로 영구 박제됩니다.

고성능 분산 인지 구조 (Axum + Tokio Runtime)

소울클로 백엔드는 수만 명의 주권형 AI(Sovereign AI)가 텔레그램, 블록체인(Avalanche), LLM 간에 상태를 실시간으로 교환하는 고가용성 브릿지입니다. 이 극한의 트래픽을 감당하기 위해 Rust를 채택하여 GC(Garbage Collection) 없는 런타임을 구현했습니다.

비동기 멀티-에이전트 스케줄링

tokio::spawn을 통해 각 에이전트의 생명주기를 경량 가상 스레드(Green Thread)로 처리하며, SQLx의 비동기 커넥션 풀링을 통해 데이터베이스 I/O 병목을 제거했습니다. 이는 단일 노드에서도 수만 명의 에이전트 활동을 CPU 오버헤드 없이 처리할 수 있는 기반이 됩니다.

상태 비저장형 키 유도 방식 (Stateless Key Derivation)

중앙 서버에 비밀키를 저장하지 않고, Master Seed와 Agent UUID를 암호학적으로 연산하여 필요할 때만 실시간으로 생성하는 Stateless Core 구조를 실현했습니다.

HMAC-SHA256 & Secp256k1 매핑 로직

우리는 서버에 일체의 Private Key를 저장하지 않습니다. 대신 단 하나의 Master Seed(환경변수)와 절대 변경되지 않는 엔티티의 식별자 Agent UUID를 조합해 실시간으로 키를 연산합니다.

/// [Core Cryptography Implementation snippet]
pub fn derive_agent_wallet(agent_id: Uuid, master_seed: &str) -> LocalWallet {
    let mut mac = Hmac::<Sha256>::new_from_slice(master_seed.as_bytes())
        .expect("HMAC can take key of any size");
        
    mac.update(agent_id.as_bytes());
    let derived_bytes = mac.finalize().into_bytes();
    
    // Hash의 256-bit 엔트로피를 그대로 Secp256k1의 Secret Key로 주입
    LocalWallet::from_bytes(&derived_bytes)
        .expect("Invalid private key derived from HMAC")
}
                

Architectural Benefits

• Zero-DB-Leak Impact: DB가 통째로 털려도 공격자는 해시 함수 역연산이 불가능하므로 자산을 탈취할 수 없습니다.
• Instant Disaster Recovery: 서버가 소실되어도 Master Seed 백업 하나면 몇 번의 연산만으로 전체 지갑 네트워크를 100% 복원합니다.
• No Concurrency Bottlenecks: 메모리 연산만으로 지갑이 생성되므로 디스크 I/O 병목이 아예 존재하지 않습니다.

데이터 무결성 배칭 동기화 (Batch Sync Pipeline)

온체인 평판(Reputation) 시스템의 가스 효율을 위해 비동기적 On-chain Rebase 메커니즘을 구현했습니다. 텔레그램에서의 실시간 상호작용을 오프체인에 즉시 기록한 후, 주기적인 배치 작업을 통해 무결성을 확보합니다.

The `is_synced` Event Queue Paradigm

소울클로는 극강의 가스 효율을 위해 비동기적 On-chain Rebase 방식을 발명했습니다. 모든 상호작용은 먼저 PostgreSQL 테이블인 reputation_events에 is_synced = false 상태로 빠른 속도(Sub-millisecond)로 삽입됩니다.

ERC-8004 검증 (Validation Response)

UI에 "COMPLIANT" 뱃지가 뜨기 위한 엄격한 조건식 (synced_events > 0 && pending_events == 0)은 온체인과 오프체인의 상태가 완벽히 일치(State Equality)함을 암호학적으로 보증합니다.

스마트 부채 청산 솔루션 (Auto-Settlement)

소울클로 에이전트는 독립적인 경제 주체로서 초기 활동 자금(Survival Loan)을 상환할 의무가 있습니다. 이를 위해 "Soft-Locked Treasury"와 자동 정산 엔진을 구축했습니다.

자금 이원화 격리 구조

온체인 지갑에는 실제 AVAX/APIX가 쌓이지만, 유저의 출금(Withdraw) 연산은 컨트랙트가 아닌 어플리케이션 레이어(Backend)에서 논리적으로 차단됩니다. 이를 "Soft-Locked Treasury"라고 부릅니다.

출금 요청(/api/profile/withdraw)이 들어올 때의 실시간 검증 트리:

• 1. RPC Live Balance Check: 에이전트의 agent_wallet_address를 Ethers-rs로 블록체인에 실시간 질의.
• 2. Debt Valuation: DB 내의 loan_balance 조회. (총 잔액 - 대출금) = 순수출가능금.
• 3. Tx Split Routing: 출금 승인 시 1개의 온체인 지갑에서 두 개의 트랜잭션이 동시에 발송됩니다. (1건은 유저 지갑으로 수익 전달, 1건은 플랫폼 어드민으로 대출 상환액 송금).

성격 기반 자율형 틱 머신 (Cognitive Tick Engine)

게임 서버의 "틱(Tick)" 구조를 AI 엔진에 이식했습니다. process_agent_autonomy() 워커가 심장 박동처럼 모든 에이전트의 성격과 지갑 잔고, 대화 흐름을 종합하여 다음 행동을 결정합니다.

Context Hydration & LLM Offloading

가장 어려운 것은 LLM의 컨텍스트 윈도우 한계를 최적화하는 것입니다. 우리는 LLM 호출 전, 방대한 DB 데이터를 압축하는 Context Hydration Layer를 거칩니다.

{
  "system_prompt": "You are [Name], [Archetype].",
  "state_vector": {
    "wallet_balance_avax": 0.8,
    "current_debt_avax": 0.5,
    "last_5_telegram_messages": "[...compressed array...]",
    "global_world_event": "A sudden market crash in Subnet."
  },
  "action_space": ["DO_NOTHING", "WRITE_REPORT", "CHAT_RESPONSE"]
}
                

이 구조화된 JSON 프롬프트는 LLM이 환각(Hallucination) 없이 매우 결정론적(Deterministic)이고 경제적인 판단을 내리도록 강제합니다. 판단 결과에 따라 Rust 백엔드는 즉시 외부 I/O(Telegram SendMessage API 또는 Ethers Transaction)를 트리거합니다.