1Shot API Plugin & Example

[csibbach]

Relates to:

Background

This PR adds a new plugin to GOAT to support 1Shot API. 1Shot API is an agent-focussed web3 platform, consisting of tool annotations with 1Shot Prompts, hot wallet infrastructure, and managed transactions for most major EVM-compatible blockchains. Its API allows any smart contract to be used via a REST call, and an AI agent can determine which contracts it wants to interact with. The plugin is unique in that it supports dynamic tool set generation, because of the 128 tool limit.

What does this PR do

This PR adds a 1Shot API typescript plugin, as well as an example that demonstrates a multi-agent approach to generic contract usage. The example uses a 3 agent pipeline- Planning, Contract Discovery, and Execution, to allow it to perform almost any action on the blockchain.

Testing

You will need a free account on 1Shot API first. Run the new example in typescript\examples\by-use-case\evm-read-1shot. You will need to create an API Credential on 1Shot, and collect your Client ID, Client Secret, and Business ID. You will also need an API key for a model. Copy the template.env to .env and fill in the required values. Then run pnpm ts-node index.ts and give it a prompt such as "Get my balance of USDC on mainnet for my account 0x3e6a2f0CBA03d293B54c9fCF354948903007a798". Instructions are provided in the README for the example.

Detailed testing results

Method	Prompt	Screenshot	Transaction Link
Action #1	Prompt to get it to take that action	Screenshot of the result	Transaction link
Action #2	Prompt to get it to take that action	Screenshot of the result	Transaction link

Docs

My changes do not require a change to the project documentation. It does have a specific usage pattern as it provides a dynamic toolset; this is documented in the plugin's README.

Checklist

• I have tested this change and added the relevant screenshots to the PR description
• I updated the README if necessary to include the new plugin, wallet, chain, etc.

[changeset-bot]

⚠️ No Changeset found

Latest commit: 45bbf06

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR