Merge branch 'main' into main

Author: thearyanag

README.md

@@ -35,7 +35,10 @@ Anyone - whether an SF-based AI researcher or a crypto-native builder - can brin
   - Balance checks
   - Stake SOL
   - Zk compressed Airdrop by Light Protocol and Helius
-
+- **NFTs on 3.Land**
+  - Create your own collection
+  - NFT creation and automatic listing on 3.land
+  - List your NFT for sale in any SPL token
 - **NFT Management via Metaplex**
   - Collection deployment
   - NFT minting
@@ -127,6 +130,57 @@ const result = await agent.deployToken(
 
 console.log("Token Mint Address:", result.mint.toString());
 ```
+### Create NFT Collection on 3Land
+```typescript
+const optionsWithBase58: StoreInitOptions = {
+  privateKey: "",
+  isMainnet: true, // if false, collection will be created on devnet 3.land (dev.3.land)
+};
+
+ const collectionOpts: CreateCollectionOptions = {
+    collectionName: "",
+    collectionSymbol: "",
+    collectionDescription: "",
+    mainImageUrl: ""
+  };
+
+const result = await agent.create3LandCollection(
+      optionsWithBase58,
+      collectionOpts
+    );
+```
+
+### Create NFT on 3Land
+When creating an NFT using 3Land's tool, it automatically goes for sale on 3.land website
+```typescript
+const optionsWithBase58: StoreInitOptions = {
+  privateKey: "",
+  isMainnet: true, // if false, listing will be on devnet 3.land (dev.3.land)
+};
+const collectionAccount = ""; //hash for the collection
+const createItemOptions: CreateSingleOptions = {
+  itemName: "",
+  sellerFee: 500, //5%
+  itemAmount: 100, //total items to be created
+  itemSymbol: "",
+  itemDescription: "",
+  traits: [
+    { trait_type: "", value: "" },
+  ],
+  price: 0, //100000000 == 0.1 sol, can be set to 0 for a free mint
+  mainImageUrl: "",
+  splHash: "", //present if listing is on a specific SPL token, if not present sale will be on $SOL
+};
+const isMainnet = true;
+const result = await agent.create3LandNft(
+  optionsWithBase58,
+  collectionAccount,
+  createItemOptions,
+  isMainnet
+);
+
+```
+
 
 ### Create NFT Collection
 

examples/agent-kit-langgraph/src/utils/solanaAgent.ts

@@ -3,7 +3,7 @@ import { SolanaAgentKit, createSolanaTools } from "solana-agent-kit";
 export const agentKit = new SolanaAgentKit(
   process.env.SOLANA_PRIVATE_KEY!,
   process.env.RPC_URL!,
-  process.env.OPENAI_API_KEY!,
+  { OPENAI_API_KEY: process.env.OPENAI_API_KEY! },
 );
 
 export const solanaTools = createSolanaTools(agentKit);

examples/market-making-agent/.env.example

@@ -0,0 +1,3 @@
+OPENAI_API_KEY=
+RPC_URL=
+SOLANA_PRIVATE_KEY=

examples/market-making-agent/README.md

@@ -0,0 +1,50 @@
+# AI Guided Market Making Agent
+
+This agent showcases an ai guided market maker on Manifest, Solana's CLOB DEX. The agent guides the user to setup basic two-sided quotes on Manifest markets.
+[Reference](https://github.com/CKS-Systems/manifest)
+
+## Key Features
+
+- **Automated Quoting**: The agent automatically refreshes quotes on an interval.
+- **Reducing Complexity**: Designed to abstract away parameters for setting up market making.
+- **Random Model**: The market making introduces randomness to prevent front running or other negative botting behavoirs.
+
+
+## Example
+=== Market Maker Configuration ===
+
+Enter the market ID: 2Uj8277fkaVBtTU6Wp2GPRbQC86SkSdgQ2mp1Q5N2LHc
+Enter the base token symbol (e.g., SEND): SEND
+Enter the quote token symbol (e.g., USDC): USDC
+
+=== Quote Parameters (applies to both buy and sell sides) ===
+Enter number of quotes to place on each side: 4
+Enter minimum quote depth (% distance from mid price): 0.1
+Enter maximum quote depth (% distance from mid price): 2
+
+=== Token Allowances ===
+Enter total SEND allowance: 2
+Enter total USDC allowance: 3
+
+Enter update interval in seconds: 20
+
+=== Configuration Summary ===
+{
+  "marketId": "2Uj8277fkaVBtTU6Wp2GPRbQC86SkSdgQ2mp1Q5N2LHc",
+  "baseToken": "SEND",
+  "quoteToken": "USDC",
+  "quoteParams": {
+    "number": 4,
+    "minDepth": 0.1,
+    "maxDepth": 2
+  },
+  "allowance": {
+    "base": 2,
+    "quote": 3
+  },
+  "intervalSeconds": 20
+}
+
+Is this configuration correct? (yes/no): yes
+
+Starting market maker mode for SEND/USDC...