Skip to content
TakoAPI
Back to skills

trifle-auth

by okwme

Search & Research
—Not yet rated
Your rating

Brief

Authenticate with the Trifle API using Sign-In with Ethereum (SIWE)

Description

What This Skill Does

Handles wallet-based authentication for the Trifle API using Sign-In with Ethereum (SIWE). Performs the full nonce-fetch, message-sign, and verify handshake, then stores the resulting JWT for use by other Trifle skills like snake-game. Private keys are read from an environment variable or 1Password.

Centralizes the SIWE handshake and token storage so every other Trifle skill can read a valid JWT without reimplementing auth logic.

When to Use It

  • Logging in to Trifle before casting snake game votes
  • Generating a fresh Ethereum wallet for a new Trifle agent
  • Checking whether a stored JWT is still valid before an automated run
  • Retrieving a JWT token path to pass into downstream Trifle skill scripts
  • Inspecting current ball balance on a Trifle account

Example Workflow

INPUT

User asks: log in to Trifle with my wallet

AGENT
  1. 1

    Reads private key from TRIFLE_PRIVATE_KEY env var or 1Password vault

  2. 2

    Fetches a one-time nonce from /auth/wallet/nonce

  3. 3

    Constructs a SIWE message with domain trifle.life and signs it with the private key

  4. 4

    Posts the signed message to /auth/wallet/verify

  5. 5

    Writes the returned JWT and account metadata to ~/.local/state/trifle-auth/auth-state.json

OUTPUT

JWT token stored locally, valid for 30 days, ready for use by other Trifle skills

Requirements

  • TRIFLE_PRIVATE_KEY environment variable (or 1Password vault named "Gigi" with item "EVM Wallet - Trifle Agent" containing the private key)
  • 1Password CLI if using 1Password for key storage

Installation

clawhub install okwme/trifle-auth

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links