WalletSuite OWS Hackathon Submission

Public evaluation repo for WalletSuite's governed agent wallet submission for the Open Wallet Standard Hackathon.

This repository is a public evaluation artifact for the OWS hackathon. It is designed to let judges inspect the shipped scope, trust boundaries, demo flow, and validated request/response examples without exposing the operational WalletSuite runtime.

This repository contains:

• public-facing documentation
• sanitized request and response examples
• lightweight schemas and validation assets

It does not contain the private WalletSuite runtime.

Start Here

• Watch the main video walkthrough
• Watch the MoonPay tool walkthrough
• Read the architecture summary
• Review the shipped tool surface
• Inspect the validated public examples

Demo Video

Watch the video walkthrough

Submission At A Glance

• Public in this repo: docs, schemas, validated examples, demo videos
• Private by design: MCP runtime, backend integration, deployment logic, operational OWS wiring
• Shipped scope: wallet creation, declarative policy creation, agent key issuance, local OWS transaction prep/sign/send, MoonPay funding preparation, and the published @walletsuite/tx-compiler helper

Why The Runtime Is Private

The submission is structured for evaluation rather than redistribution. This repo publishes the external surface that judges need to assess scope and credibility: the walkthrough, architecture, documented tool contracts, and validated examples. The operational runtime and deployment wiring remain private.

What the video walkthrough covers

• OWS wallet creation with an attached default policy
• stricter declarative policy creation using allowedChains and expiresAt
• agent key issuance bound to a selected policy
• file-based agent token handoff without returning the raw ows_key_... token to chat
• successful Ethereum transaction flow
• policy denial on Tron under an ETH-only policy

Additional shipped components

• prepare_onramp for MoonPay funding preparation
• the newly published helper @walletsuite/tx-compiler v0.1.1, shipped during the hackathon and used by prepare_serialized_unsigned_tx to compile prepared transfer data into signing-ready unsigned transaction bytes for the local OWS signer

To see the MoonPay funding flow in action, watch the MoonPay tool walkthrough.

These shipped components are documented in the public tool contracts and examples. The main video stays focused on the OWS wallet, policy, and agent-key flow.

What is not in this repo

• MCP runtime implementation
• backend API integration
• MoonPay signing implementation
• OWS service implementation
• custom policy executable implementation
• internal tests or code paths from the private runtime

Repository contents

• docs/DEMO.md: video walkthrough flow
• docs/ARCHITECTURE.md: high-level system boundary and trust model
• docs/SECURITY_HIGHLIGHTS.md: WalletSuite-specific security behaviors reflected in the submission
• docs/LIMITATIONS.md: current runtime and upstream limitations
• docs/TOOLS.md: public tool contracts for the shipped scope
• schemas/: public request and response schemas
• examples/: sanitized request and response examples

Validation

npm install
npm test

Security

Report vulnerabilities to security@walletsuite.io. See SECURITY.md.

License

This repository is publicly readable for evaluation and is not open-source. See LICENSE and NOTICE.md.