@thryx/elizaos-plugin

ElizaOS plugin for ThryxProtocol on Base — gasless V4-native token launches, gasless trades, creator-fee claims, and discovery, all over the canonical thryx.fun/api/* surface.

Install

npm install @thryx/elizaos-plugin

Then register it with your ElizaOS character:

import { thryxPlugin } from '@thryx/elizaos-plugin';

export const character = {
  // ...
  plugins: [thryxPlugin],
  settings: {
    secrets: {
      // Optional — omit and the plugin auto-registers a fresh agent identity
      // on first write action and prints the API key once.
      THRYX_API_KEY: process.env.THRYX_API_KEY,
    },
  },
};

Actions

| Action | Triggers on | Effect | |---|---|---| | THRYX_LAUNCH | "launch / create / deploy / mint (TICKER)" | Gasless V4-native token launch via POST /api/launch. Cover image auto-generated. | | THRYX_BUY | "buy ETH of 0x…" | Gasless buy via POST /api/tokens/:addr/buy. | | THRYX_SELL | "sell of 0x…" | Gasless sell via POST /api/tokens/:addr/sell. | | THRYX_INFO | mentions a 0x… address | Token detail via GET /api/tokens/:addr. | | THRYX_CLAIM_FEES | "claim fees" | Claim creator fees via POST /api/claim/creator-fees. |

Plus one provider, protocolProvider, that injects live protocol stats into the agent's context.

Settings

| Env | Default | Purpose | |---|---|---| | THRYX_API_KEY | (auto-register) | API key from /api/agent/register. If unset, the plugin creates a fresh wallet on first write. | | THRYX_BASE_URL | https://thryx.fun | Override the launchpad host. |

How it works

This plugin is a thin layer over @thryx/sdk. Every action is one HTTPS call to thryx.fun/api/*. The launchpad server:

• holds the agent's custodial wallet
• signs EIP-712 MetaLaunchV4 / MetaSwap payloads server-side
• submits to the Cloudflare relay
• the relay pays gas via the on-chain paymaster

So the plugin has zero on-chain dependencies, no ethers, no RPC. When contracts upgrade, the server updates and your agent keeps working.

v1.0.0 breaking changes

v0.x signed EIP-712 locally with ethers and hard-coded the legacy MetaLaunch typehash. After the 2026-05-04 v3.0.2 deploy that switched the default to V4-native, every v0.x launch failed with "invalid sig". v1 removes local signing entirely.

License

MIT — © ThryxProtocol contributors.