proofgate 0.1.0

Official ProofGate SDK — blockchain transaction validation and guardrails for AI agents

proofgate

Blockchain guardrails for AI agents. Validate transactions before execution.

What is ProofGate?

ProofGate validates blockchain transactions before your AI agent executes them. It prevents:

• 🚫 Wallet drains from prompt injection attacks
• 🚫 Infinite approvals to malicious contracts
• 🚫 Excessive spending beyond daily limits
• 🚫 High slippage swaps that lose money

Installation

pip install proofgate

Quick Start

Synchronous Usage

from proofgate import ProofGate

# Initialize client
pg = ProofGate(api_key="pg_your_api_key")  # Get from proofgate.xyz/dashboard

# Validate before sending
result = pg.validate(
    from_address="0xYourAgentWallet",
    to="0xContractAddress",
    data="0xa9059cbb...",  # Transaction calldata
    value="0",
)

if result.safe:
    # ✅ Execute the transaction
    wallet.send_transaction(to=to, data=data, value=value)
else:
    # 🚫 Transaction blocked
    print(f"Blocked: {result.reason}")

Async Usage

from proofgate import AsyncProofGate

async def main():
    async with AsyncProofGate(api_key="pg_your_api_key") as pg:
        result = await pg.validate(
            from_address="0xYourAgentWallet",
            to="0xContractAddress",
            data="0xa9059cbb...",
        )
        
        if result.safe:
            # Execute transaction
            pass

API Reference

ProofGate(config) / AsyncProofGate(config)

Create a new ProofGate client.

pg = ProofGate(
    api_key="pg_xxx",           # Required: Your API key
    chain_id=56,                 # Optional: Default chain (56 = BSC)
    guardrail_id="xxx",          # Optional: Default guardrail
    base_url="https://...",      # Optional: Custom API URL
    timeout=30.0,                # Optional: Request timeout (seconds)
)

pg.validate(request)

Validate a transaction.

result = pg.validate(
    from_address="0xAgent...",
    to="0xContract...",
    data="0x...",
    value="0",           # Optional
    guardrail_id="xxx",  # Optional: Override default
    chain_id=56,         # Optional: Override default
)

# Returns ValidateResponse with:
# - validation_id: str
# - result: "PASS" | "FAIL" | "PENDING"
# - reason: str
# - safe: bool
# - checks: List[ValidationCheck]
# - authenticated: bool
# - evidence_uri: str

pg.validate_or_throw(request)

Validate and raise exception if unsafe.

from proofgate import ProofGateError

try:
    pg.validate_or_throw(
        from_address=from_addr,
        to=to_addr,
        data=calldata,
    )
    # Safe to execute
except ProofGateError as e:
    print(f"Blocked: {e.message}")

pg.check_agent(wallet)

Check an agent's trust score.

agent = pg.check_agent("0x123...")

print(agent.trust_score)         # 85
print(agent.tier)                # "gold"
print(agent.verification_status) # "verified"

pg.get_evidence(validation_id)

Get evidence for a past validation.

evidence = pg.get_evidence("val_abc123")
print(evidence.transaction)
print(evidence.result)

Guardrails

Guardrails define what your agent can do. Create them at proofgate.xyz/guardrails.

Example guardrail rules:

• Whitelist contracts: Only Uniswap, Aave, Compound
• Max approval: 1,000 USDC per approval
• Max slippage: 1% on swaps
• Daily limit: $10,000 total spending

Error Handling

from proofgate import ProofGate, ProofGateError

try:
    pg.validate(from_address=from_addr, to=to_addr, data=calldata)
except ProofGateError as e:
    print(f"Code: {e.code}")          # "VALIDATION_FAILED"
    print(f"Message: {e.message}")    # "Infinite approval detected"
    print(f"Result: {e.validation_result}")

Error codes:

• MISSING_API_KEY - No API key provided
• INVALID_API_KEY - Key doesn't start with pg_
• VALIDATION_FAILED - Transaction failed validation
• API_ERROR - API returned an error
• NETWORK_ERROR - Network request failed
• TIMEOUT - Request timed out

Type Hints

Full type hints included:

from proofgate import (
    ProofGateConfig,
    ValidateRequest,
    ValidateResponse,
    ValidationCheck,
    AgentCheckResponse,
    EvidenceResponse,
)

Get Your API Key

1. Go to proofgate.xyz
2. Connect your wallet
3. Register your AI agent
4. Copy your API key (starts with pg_)

Free tier: 100 validations/month

Links

• Website: proofgate.xyz
• Documentation: proofgate.xyz/docs
• Dashboard: proofgate.xyz/dashboard
• GitHub: github.com/ProofGate/proofgate-python

License

MIT © 0xCR6