mirror of
https://github.com/hwchase17/langchain.git
synced 2026-02-21 06:33:41 +00:00
231 lines
7.8 KiB
Plaintext
231 lines
7.8 KiB
Plaintext
{
|
|
"cells": [
|
|
{
|
|
"cell_type": "raw",
|
|
"id": "afaf8039",
|
|
"metadata": {
|
|
"vscode": {
|
|
"languageId": "raw"
|
|
}
|
|
},
|
|
"source": [
|
|
"---\n",
|
|
"sidebar_label: GOAT\n",
|
|
"---"
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "markdown",
|
|
"id": "e49f1e0d",
|
|
"metadata": {},
|
|
"source": [
|
|
"# GOAT\n",
|
|
"\n",
|
|
"## Overview\n",
|
|
"[GOAT](https://github.com/goat-sdk/goat) is the finance toolkit for AI agents.\n",
|
|
"\n",
|
|
"Create agents that can:\n",
|
|
"\n",
|
|
"- Send and receive payments\n",
|
|
"- Purchase physical and digital goods and services\n",
|
|
"- Engage in various investment strategies:\n",
|
|
" - Earn yield\n",
|
|
" - Bet on prediction markets\n",
|
|
"- Purchase crypto assets\n",
|
|
"- Tokenize any asset\n",
|
|
"- Get financial insights\n",
|
|
"\n",
|
|
"### How it works\n",
|
|
"GOAT leverages blockchains, cryptocurrencies (such as stablecoins), and wallets as the infrastructure to enable agents to become economic actors:\n",
|
|
"\n",
|
|
"1. Give your agent a [wallet](https://github.com/goat-sdk/goat/tree/main#chains-and-wallets)\n",
|
|
"2. Allow it to transact [anywhere](https://github.com/goat-sdk/goat/tree/main#chains-and-wallets)\n",
|
|
"3. Use more than [+200 tools](https://github.com/goat-sdk/goat/tree/main#tools)\n",
|
|
"\n",
|
|
"See everything GOAT supports [here](https://github.com/goat-sdk/goat/tree/main#chains-and-wallets).\n",
|
|
"\n",
|
|
"**Lightweight and extendable**\n",
|
|
"Different from other toolkits, GOAT is designed to be lightweight and extendable by keeping its core minimal and allowing you to install only the tools you need.\n",
|
|
"\n",
|
|
"If you don't find what you need on our more than 200 integrations you can easily:\n",
|
|
"\n",
|
|
"- Create your own plugin\n",
|
|
"- Integrate a new chain\n",
|
|
"- Integrate a new wallet\n",
|
|
"- Integrate a new agent framework\n",
|
|
"\n",
|
|
"See how to do it [here](https://github.com/goat-sdk/goat/tree/main#-contributing)."
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "markdown",
|
|
"id": "0730d6a1-c893-4840-9817-5e5251676d5d",
|
|
"metadata": {},
|
|
"source": [
|
|
"### Quickstarts\n",
|
|
"\n",
|
|
"The best way to get started is by using the quickstarts below. See how you can configure GOAT to achieve any of the use cases below.\n",
|
|
"\n",
|
|
"- **By use case**\n",
|
|
" - **Money transmission**\n",
|
|
" - Send and receive payments [[EVM](https://github.com/goat-sdk/goat/tree/main/python/examples/by-use-case/evm-send-and-receive-tokens), [Solana](https://github.com/goat-sdk/goat/tree/main/python/examples/by-use-case/solana-send-and-receive-tokens)]\n",
|
|
" - **Investing**\n",
|
|
" - Generate yield [[Solana](https://github.com/goat-sdk/goat/tree/main/python/examples/by-use-case/solana-usdc-yield-deposit)]\n",
|
|
" - Purchase crypto assets [[EVM](https://github.com/goat-sdk/goat/tree/main/python/examples/by-use-case/evm-swap-tokens), [Solana](https://github.com/goat-sdk/goat/tree/main/python/examples/by-use-case/solana-swap-tokens)]\n",
|
|
"- **By wallet**\n",
|
|
" - [Crossmint](https://github.com/goat-sdk/goat/tree/main/python/examples/by-wallet/crossmint)\n",
|
|
"- **See all python quickstarts [here](https://github.com/goat-sdk/goat/tree/main/python/examples).**\n"
|
|
]
|
|
},
|
|
{
|
|
"cell_type": "markdown",
|
|
"id": "abd26764",
|
|
"metadata": {},
|
|
"source": [
|
|
"## Setup\n",
|
|
"\n",
|
|
"1. Install the core package and langchain adapter:\n",
|
|
"\n",
|
|
"```bash\n",
|
|
"pip install goat-sdk goat-sdk-adapter-langchain\n",
|
|
"```\n",
|
|
"\n",
|
|
"2. Install the type of wallet you want to use (e.g solana):\n",
|
|
"\n",
|
|
"```bash\n",
|
|
"pip install goat-sdk-wallet-solana\n",
|
|
"```\n",
|
|
"\n",
|
|
"3. Install the plugins you want to use in that chain:\n",
|
|
"\n",
|
|
"```bash\n",
|
|
"pip install goat-sdk-plugin-spl-token\n",
|
|
"```\n",
|
|
"\n",
|
|
"## Instantiation\n",
|
|
"\n",
|
|
"Now we can instantiate our toolkit:\n",
|
|
"\n",
|
|
"```python\n",
|
|
"from goat_adapters.langchain import get_on_chain_tools\n",
|
|
"from goat_wallets.solana import solana, send_solana\n",
|
|
"from goat_plugins.spl_token import spl_token, SplTokenPluginOptions\n",
|
|
"from goat_plugins.spl_token.tokens import SPL_TOKENS\n",
|
|
"\n",
|
|
"# Initialize Solana client\n",
|
|
"client = SolanaClient(os.getenv(\"SOLANA_RPC_ENDPOINT\"))\n",
|
|
"\n",
|
|
"# Initialize regular Solana wallet\n",
|
|
"keypair = Keypair.from_base58_string(os.getenv(\"SOLANA_WALLET_SEED\") or \"\")\n",
|
|
"wallet = solana(client, keypair)\n",
|
|
"\n",
|
|
"tools = get_on_chain_tools(\n",
|
|
" wallet=wallet,\n",
|
|
" plugins=[\n",
|
|
" send_solana(),\n",
|
|
" spl_token(SplTokenPluginOptions(\n",
|
|
" network=\"mainnet\", # Using devnet as specified in .env\n",
|
|
" tokens=SPL_TOKENS\n",
|
|
" )),\n",
|
|
" ],\n",
|
|
" )\n",
|
|
"```\n",
|
|
"\n",
|
|
"## Invocation\n",
|
|
"```python\n",
|
|
"tools[\"get_balance\"].invoke({ \"address\": \"0x1234567890123456789012345678901234567890\" })\n",
|
|
"```\n",
|
|
"\n",
|
|
"## Use within an agent\n",
|
|
"\n",
|
|
"```python\n",
|
|
"import os\n",
|
|
"import asyncio\n",
|
|
"from dotenv import load_dotenv\n",
|
|
"\n",
|
|
"# Load environment variables\n",
|
|
"load_dotenv()\n",
|
|
"\n",
|
|
"from langchain_openai import ChatOpenAI\n",
|
|
"from langchain.agents import AgentExecutor, create_tool_calling_agent\n",
|
|
"from langchain_core.prompts import ChatPromptTemplate\n",
|
|
"from solana.rpc.api import Client as SolanaClient\n",
|
|
"from solders.keypair import Keypair\n",
|
|
"\n",
|
|
"from goat_adapters.langchain import get_on_chain_tools\n",
|
|
"from goat_wallets.solana import solana, send_solana\n",
|
|
"from goat_plugins.spl_token import spl_token, SplTokenPluginOptions\n",
|
|
"from goat_plugins.spl_token.tokens import SPL_TOKENS\n",
|
|
"\n",
|
|
"# Initialize Solana client\n",
|
|
"client = SolanaClient(os.getenv(\"SOLANA_RPC_ENDPOINT\"))\n",
|
|
"\n",
|
|
"# Initialize regular Solana wallet\n",
|
|
"keypair = Keypair.from_base58_string(os.getenv(\"SOLANA_WALLET_SEED\") or \"\")\n",
|
|
"wallet = solana(client, keypair)\n",
|
|
"\n",
|
|
"# Initialize LLM\n",
|
|
"llm = ChatOpenAI(model=\"gpt-4o-mini\")\n",
|
|
"\n",
|
|
"def main():\n",
|
|
" \n",
|
|
" # Get the prompt template\n",
|
|
" prompt = ChatPromptTemplate.from_messages(\n",
|
|
" [\n",
|
|
" (\"system\", \"You are a helpful assistant\"),\n",
|
|
" (\"placeholder\", \"{chat_history}\"),\n",
|
|
" (\"human\", \"{input}\"),\n",
|
|
" (\"placeholder\", \"{agent_scratchpad}\"),\n",
|
|
" ]\n",
|
|
" )\n",
|
|
"\n",
|
|
" # Initialize tools with Solana wallet\n",
|
|
" tools = get_on_chain_tools(\n",
|
|
" wallet=wallet,\n",
|
|
" plugins=[\n",
|
|
" send_solana(),\n",
|
|
" spl_token(SplTokenPluginOptions(\n",
|
|
" network=\"mainnet\", # Using devnet as specified in .env\n",
|
|
" tokens=SPL_TOKENS\n",
|
|
" )),\n",
|
|
" ],\n",
|
|
" )\n",
|
|
"\n",
|
|
" # Initialize agent\n",
|
|
" # Your agent code here\n",
|
|
"\n",
|
|
"\n",
|
|
"if __name__ == \"__main__\":\n",
|
|
" main()\n",
|
|
"```\n",
|
|
"\n",
|
|
"## API reference\n",
|
|
"\n",
|
|
"- For a complete list of tools, see the [GOAT SDK documentation](https://github.com/goat-sdk/goat).\n",
|
|
"\n"
|
|
]
|
|
}
|
|
],
|
|
"metadata": {
|
|
"kernelspec": {
|
|
"display_name": "Python 3 (ipykernel)",
|
|
"language": "python",
|
|
"name": "python3"
|
|
},
|
|
"language_info": {
|
|
"codemirror_mode": {
|
|
"name": "ipython",
|
|
"version": 3
|
|
},
|
|
"file_extension": ".py",
|
|
"mimetype": "text/x-python",
|
|
"name": "python",
|
|
"nbconvert_exporter": "python",
|
|
"pygments_lexer": "ipython3",
|
|
"version": "3.10.4"
|
|
}
|
|
},
|
|
"nbformat": 4,
|
|
"nbformat_minor": 5
|
|
}
|