Skip to content

Commit 3316d7a

Browse files
karimodm0xaguspunk
karimodm
and
0xaguspunk
authored
Python Mint Service for Crossmint Wallets (#433)
* Mint plugin for Crossmint * Wrong PluginBase inheritance for crossmint plugin * Examples with READMEs * Patch release of goat-sdk-wallet-crossmint * Post-merge fixes --------- Co-authored-by: Agustin Armellini Fischer <armellini13@gmail.com>
1 parent a83715e commit 3316d7a

24 files changed

+7269
-99
lines changed

‎python/README.md

+2
Original file line numberDiff line numberDiff line change
@@ -76,6 +76,8 @@ GOAT is free software, MIT licensed.
7676
- **Investing**
7777
- Generate yield [[Solana](https://github.com/goat-sdk/goat/tree/main/python/examples/by-use-case/solana-usdc-yield-deposit)]
7878
- 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)]
79+
- **Tokenization**
80+
- Tokenize non-fungible assets [[EVM](https://github.com/goat-sdk/goat/tree/main/python/examples/by-use-case/evm-mint-nft), [Solana](https://github.com/goat-sdk/goat/tree/main/python/examples/by-use-case/solana-mint-nft)]
7981
- **By framework**
8082
- [Langchain](https://github.com/goat-sdk/goat/tree/main/python/examples/by-framework/langchain)
8183
- [OpenAI Agents SDK](https://github.com/goat-sdk/goat/tree/main/python/examples/by-framework/openai-agents-sdk)

‎python/examples/by-use-case/evm-mint-nft/.env.template

+4
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
OPENAI_API_KEY=
2+
WALLET_PRIVATE_KEY=
3+
RPC_PROVIDER_URL=
4+
CROSSMINT_API_KEY=

‎python/examples/by-use-case/evm-mint-nft/README.md

+69
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
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+
# Mint an NFT on EVM
6+
## 🚀 Quickstart
7+
8+
This example demonstrates how to use GOAT to **mint an NFT on EVM** using [Crossmint](https://www.crossmint.com/). It also includes the ability to create wallets for X/Twitter users and emails and drop NFTs into those wallets. This example uses **Ethereum Sepolia** but you can implement it with any other EVM network by changing the chain and RPC URL.
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/evm-mint-nft
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+
- `WALLET_PRIVATE_KEY`
29+
- `RPC_PROVIDER_URL`
30+
- `CROSSMINT_API_KEY` - Use staging key for development, production key for mainnet
31+
32+
4. Install dependencies:
33+
```bash
34+
poetry install
35+
```
36+
37+
## Usage
38+
1. Run the interactive CLI:
39+
```bash
40+
poetry run python index.py
41+
```
42+
43+
2. Chat with the agent:
44+
- Create a wallet for an X/Twitter user or email
45+
- Mint an NFT to the wallet
46+
47+
3. To use the production key, set the `CROSSMINT_API_KEY` environment variable to your production key and change the chain to a mainnet chain.
48+
49+
## Using in production
50+
In production, developers require advanced wallet setups that utilize [smart wallets](https://docs.goat-sdk.com/concepts/smart-wallets), which allow them to:
51+
1. **Increase security** by setting programmable permissions (e.g. limiting fund amounts, restricting contract interactions, and defining required signatures)
52+
2. **Maintain regulatory compliance** by ensuring agent wallets are non-custodial. This means that:
53+
- Launchpads, wallet providers, or agent platforms never have access to agents' wallets.
54+
- Agent platforms do not require money transmitter licenses.
55+
56+
### Agent Wallets
57+
[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).
58+
59+
To integrate Agent Wallets with GOAT, check out the following quickstarts:
60+
1. Agent Wallets Quickstart [[EVM](https://github.com/goat-sdk/goat/tree/main/typescript/examples/by-wallet/crossmint-smart-wallets), [Solana](https://github.com/goat-sdk/goat/tree/main/typescript/examples/by-wallet/crossmint-smart-wallets)]
61+
2. [Agent Launchpad Starter Kit](https://github.com/Crossmint/agent-launchpad-starter-kit/)
62+
63+
<footer>
64+
<br/>
65+
<br/>
66+
<div>
67+
<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;">
68+
<div>
69+
</footer>

‎python/examples/by-use-case/evm-mint-nft/example.py

+96
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,96 @@
1+
import os
2+
import json
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 web3 import Web3
12+
from web3.middleware import SignAndSendRawMiddlewareBuilder
13+
from eth_account.signers.local import LocalAccount
14+
from eth_account import Account
15+
16+
from goat_adapters.langchain import get_on_chain_tools
17+
from goat_wallets.web3 import Web3EVMWalletClient
18+
from goat_wallets.crossmint import crossmint
19+
20+
# Configure environment
21+
OPENAI_API_KEY = os.getenv("OPENAI_API_KEY")
22+
WALLET_PRIVATE_KEY = os.getenv("WALLET_PRIVATE_KEY")
23+
RPC_PROVIDER_URL = os.getenv("RPC_PROVIDER_URL")
24+
CROSSMINT_API_KEY = os.getenv("CROSSMINT_API_KEY")
25+
26+
if not all([OPENAI_API_KEY, WALLET_PRIVATE_KEY, RPC_PROVIDER_URL, CROSSMINT_API_KEY]):
27+
raise ValueError("Missing required environment variables. Check your .env file.")
28+
29+
# Initialize Web3 and account
30+
w3 = Web3(Web3.HTTPProvider(RPC_PROVIDER_URL))
31+
account: LocalAccount = Account.from_key(WALLET_PRIVATE_KEY)
32+
w3.eth.default_account = account.address
33+
w3.middleware_onion.add(
34+
SignAndSendRawMiddlewareBuilder.build(account)
35+
) # Add middleware
36+
37+
# Initialize LLM
38+
llm = ChatOpenAI(model="gpt-4o-mini")
39+
40+
def main():
41+
print("Welcome to the Mint NFT on EVM using Crossmint example!")
42+
print("This agent can:")
43+
print("- Create a wallet for an X/Twitter user or email")
44+
print("- Mint an NFT to the wallet")
45+
print("\nType 'exit' to quit the conversation.\n")
46+
47+
# Get the prompt template
48+
prompt = ChatPromptTemplate.from_messages(
49+
[
50+
("system", """You are a helpful NFT minting assistant.
51+
You can help users create wallets for X/Twitter users or emails and mint NFTs to those wallets.
52+
53+
When a user asks you to mint an NFT, remember to:
54+
1. Create a collection if none exists
55+
2. Check if a wallet exists for the recipient, or create one
56+
3. Mint the NFT to the recipient's wallet
57+
58+
Only use the provided tools to interact with the blockchain."""),
59+
("placeholder", "{chat_history}"),
60+
("human", "{input}"),
61+
("placeholder", "{agent_scratchpad}"),
62+
]
63+
)
64+
65+
# Initialize tools with web3 wallet and Crossmint
66+
wallet_client = Web3EVMWalletClient(w3)
67+
crossmint_factory = crossmint(CROSSMINT_API_KEY)
68+
69+
tools = get_on_chain_tools(
70+
wallet=wallet_client,
71+
plugins=[
72+
crossmint_factory["mint"](),
73+
],
74+
)
75+
76+
agent = create_tool_calling_agent(llm, tools, prompt)
77+
agent_executor = AgentExecutor(agent=agent, tools=tools, handle_parsing_errors=True, verbose=True)
78+
79+
while True:
80+
user_input = input("\nYou: ")
81+
82+
if user_input.lower() == "exit":
83+
print("Goodbye!")
84+
break
85+
86+
try:
87+
response = agent_executor.invoke({
88+
"input": user_input,
89+
})
90+
91+
print("\nAssistant:", response["output"])
92+
except Exception as e:
93+
print("\nError:", str(e))
94+
95+
if __name__ == "__main__":
96+
main()

0 commit comments

Comments
 (0)