Skip to content

Commit fb5fc9f

Browse files
karimodmkarimodm
authored
Python LULO plugin & important TypeScript fix (#431)
* Merge remote-tracking branch 'origin/devin/1741759081-python-lulo-client' into python-lulo * Move and fix Lulo example * Lulo TS example * Do not insert latestBlockhash on raw transaction, we invalidate signatures! * Improve comment * Monorepo LULO dependency * README and publishing * Refresh lockfile * Linting * Fix for workspace * Linting * Update README * Add clarification comment
1 parent b9406be commit fb5fc9f

File tree

25 files changed

+5983
-19
lines changed

25 files changed

+5983
-19
lines changed

‎README.md

+1
Original file line numberDiff line numberDiff line change
@@ -107,6 +107,7 @@ GOAT is free software, MIT licensed.
107107
- **By use case**
108108
- Send and receive tokens [[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)]
109109
- Swap tokens [[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)]
110+
- Deposit USDC into Lulo Yield Platform [[Solana](https://github.com/goat-sdk/goat/tree/main/python/examples/by-use-case/solana-usdc-yield-deposit)]
110111
- **By framework**
111112
- [Langchain](https://github.com/goat-sdk/goat/tree/main/python/examples/by-framework/langchain)
112113
- [OpenAI Agents SDK](https://github.com/goat-sdk/goat/tree/main/python/examples/by-framework/openai-agents-sdk)

‎python/examples/by-use-case/solana-usdc-yield-deposit/.env.example

+8
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
# OpenAI API Key
2+
OPENAI_API_KEY=
3+
4+
# Solana RPC Endpoint
5+
SOLANA_RPC_ENDPOINT=https://api.devnet.solana.com
6+
7+
# Solana Wallet Seed (base58 encoded)
8+
SOLANA_WALLET_SEED=

‎python/examples/by-use-case/solana-usdc-yield-deposit/README.md

+66
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
<div align="center">
2+
<img src="https://github.com/user-attachments/assets/5fc7f121-259c-492c-8bca-f15fe7eb830c" alt="GOAT" width="100px" height="auto" style="object-fit: contain;">
3+
</div>
4+
5+
# Deposit USDC into Lulo Yield Platform
6+
## 🚀 Quickstart
7+
8+
This example demonstrates how to use GOAT to **deposit USDC into [Lulo](https://lulo.fi/)** on Solana to earn yield.
9+
10+
You can use this example with any other agent framework, chain, and wallet of your choice.
11+
12+
## Setup
13+
1. Clone the repository:
14+
```bash
15+
git clone https://github.com/goat-sdk/goat.git
16+
```
17+
18+
2. Go to the example directory:
19+
```bash
20+
cd python/examples/by-use-case/solana-usdc-yield-deposit
21+
```
22+
23+
3. Copy the `.env.template` and populate with your values:
24+
```bash
25+
cp .env.template .env
26+
```
27+
- `OPENAI_API_KEY`
28+
- `SOLANA_RPC_ENDPOINT`
29+
- `SOLANA_WALLET_SEED`
30+
31+
4. Install dependencies:
32+
```bash
33+
poetry install
34+
```
35+
36+
## Usage
37+
1. Run the interactive CLI:
38+
```bash
39+
poetry run python example.py
40+
```
41+
42+
2. Chat with the agent:
43+
- Deposit 5 USDC into Lulo
44+
45+
## Using in production
46+
In production, developers require advanced wallet setups that utilize [smart wallets](https://github.com/goat-sdk/goat/tree/main/typescript/examples/by-wallet/crossmint-smart-wallets), which allow them to:
47+
1. **Increase security** by setting programmable permissions (e.g. limiting fund amounts, restricting contract interactions, and defining required signatures)
48+
2. **Maintain regulatory compliance** by ensuring agent wallets are non-custodial. This means that:
49+
- Launchpads, wallet providers, or agent platforms never have access to agents' wallets.
50+
- Agent platforms do not require money transmitter licenses.
51+
52+
### Agent Wallets
53+
[Crossmint](https://docs.crossmint.com/wallets/quickstarts/agent-wallets) offers one of the most advanced solutions for agent developers and launchpads: [Agent Wallets](https://docs.crossmint.com/wallets/quickstarts/agent-wallets).
54+
55+
To integrate Agent Wallets with GOAT, check out the following quickstarts:
56+
1. Agent Wallets Quickstart [[EVM](https://github.com/goat-sdk/goat/tree/main/python/examples/by-wallet/crossmint), [Solana](https://github.com/goat-sdk/goat/tree/main/python/examples/by-wallet/crossmint)]
57+
2. [Agent Launchpad Starter Kit](https://github.com/Crossmint/agent-launchpad-starter-kit/)
58+
59+
<footer>
60+
<br/>
61+
<br/>
62+
<div>
63+
<img src="https://github.com/user-attachments/assets/4821833e-52e5-4126-a2a1-59e9fa9bebd7" alt="GOAT" width="100%" height="auto" style="object-fit: contain; max-width: 800px;">
64+
65+
<div>
66+
</footer>

‎python/examples/by-use-case/solana-usdc-yield-deposit/example.py

+77
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
1+
import os
2+
import asyncio
3+
from dotenv import load_dotenv
4+
5+
# Load environment variables
6+
load_dotenv()
7+
8+
from langchain_openai import ChatOpenAI
9+
from langchain.agents import AgentExecutor, create_tool_calling_agent
10+
from langchain_core.prompts import ChatPromptTemplate
11+
from solana.rpc.api import Client as SolanaClient
12+
from solders.keypair import Keypair
13+
14+
from goat_adapters.langchain import get_on_chain_tools
15+
from goat_wallets.solana import solana
16+
from goat_plugins.lulo import lulo, LuloPluginOptions
17+
from goat_plugins.spl_token import spl_token, SplTokenPluginOptions
18+
from goat_plugins.spl_token.tokens import SPL_TOKENS
19+
20+
# Initialize Solana client
21+
client = SolanaClient(os.getenv("SOLANA_RPC_ENDPOINT"))
22+
23+
# Initialize regular Solana wallet
24+
keypair = Keypair.from_base58_string(os.getenv("SOLANA_WALLET_SEED") or "")
25+
wallet = solana(client, keypair)
26+
27+
# Initialize LLM
28+
llm = ChatOpenAI(model="gpt-4o-mini")
29+
30+
def main():
31+
# Get the prompt template
32+
prompt = ChatPromptTemplate.from_messages(
33+
[
34+
("system", "You are a helpful assistant"),
35+
("placeholder", "{chat_history}"),
36+
("human", "{input}"),
37+
("placeholder", "{agent_scratchpad}"),
38+
]
39+
)
40+
41+
# Initialize tools with Solana wallet
42+
tools = get_on_chain_tools(
43+
wallet=wallet,
44+
plugins=[
45+
lulo(LuloPluginOptions()),
46+
spl_token(SplTokenPluginOptions(
47+
network="mainnet", # Using mainnet for SPL tokens
48+
tokens=SPL_TOKENS
49+
)),
50+
],
51+
)
52+
53+
agent = create_tool_calling_agent(llm, tools, prompt)
54+
agent_executor = AgentExecutor(
55+
agent=agent, tools=tools, handle_parsing_errors=True, verbose=True
56+
)
57+
58+
while True:
59+
user_input = input("\nYou: ").strip()
60+
61+
if user_input.lower() == "quit":
62+
print("Goodbye!")
63+
break
64+
65+
try:
66+
response = agent_executor.invoke(
67+
{
68+
"input": user_input,
69+
}
70+
)
71+
72+
print("\nAssistant:", response["output"])
73+
except Exception as e:
74+
print("\nError:", str(e))
75+
76+
if __name__ == "__main__":
77+
main()

0 commit comments

Comments
 (0)