Merge branch 'develop' into stargaze-merge-conflicts

Author: daniel-farina

.env.example

@@ -22,7 +22,7 @@ ETERNALAI_MODEL=                # Default: "neuralmagic/Meta-Llama-3.1-405B-Inst
 ETERNALAI_API_KEY=
 ETERNAL_AI_LOG_REQUEST=false #Default: false
 
-GROK_API_KEY=                   # GROK API Key
+GROK_API_KEY=                   # GROK/xAI API Key
 GROQ_API_KEY=                   # Starts with gsk_
 OPENROUTER_API_KEY=
 GOOGLE_GENERATIVE_AI_API_KEY=   # Gemini API key
@@ -375,4 +375,8 @@ TOKENIZER_MODEL=  # Specify the tokenizer model to be used.
 TOKENIZER_TYPE=   # Options: tiktoken (for OpenAI models) or auto (AutoTokenizer from Hugging Face for non-OpenAI models). Default: tiktoken.
 
 # Stargaze NFT marketplace from Cosmos (You can use https://graphql.mainnet.stargaze-apis.com/graphql)
-STARGAZE_ENDPOINT=
+STARGAZE_ENDPOINT=
+
+# GenLayer
+GENLAYER_PRIVATE_KEY=0x0000000000000000000000000000000000000000000000000000000000000000 # Private key of the GenLayer account to use for the agent
+

CHANGELOG.md

@@ -312,7 +312,7 @@
 - chore: bump version to v0.1.7-alpha.1 [\#1361](https://github.com/elizaOS/eliza/pull/1361) ([shakkernerd](https://github.com/shakkernerd))
 - chore: New version 0.1.7 alpha.1 [\#1360](https://github.com/elizaOS/eliza/pull/1360) ([shakkernerd](https://github.com/shakkernerd))
 - chore: develop -\> main, change elizaos/eliza to elizaos/core [\#1359](https://github.com/elizaOS/eliza/pull/1359) ([lalalune](https://github.com/lalalune))
-- feat: change @elizaos/eliza to @elizaos/core [\#1357](https://github.com/elizaOS/eliza/pull/1357) ([lalalune](https://github.com/lalalune))
+- feat: change @elizaos/core to @elizaos/core [\#1357](https://github.com/elizaOS/eliza/pull/1357) ([lalalune](https://github.com/lalalune))
 - chore: Merge Develop into Main [\#1356](https://github.com/elizaOS/eliza/pull/1356) ([lalalune](https://github.com/lalalune))
 - chore: revert discord url [\#1355](https://github.com/elizaOS/eliza/pull/1355) ([madjin](https://github.com/madjin))
 - Update DOCUMENTATION links to point to https://elizaOS.github.io/eliza/ [\#1353](https://github.com/elizaOS/eliza/pull/1353) ([imwylin](https://github.com/imwylin))
@@ -502,7 +502,7 @@
 - Agent Responds Twice to prompts [\#726](https://github.com/elizaOS/eliza/issues/726)
 - Twitter Client Breaks out of the box [\#673](https://github.com/elizaOS/eliza/issues/673)
 - Twitter client only works for one agent when running multiple agents simultaneously [\#656](https://github.com/elizaOS/eliza/issues/656)
-- Cannot find module '@ai16z/eliza' or its corresponding type declarations. [\#601](https://github.com/elizaOS/eliza/issues/601)
+- Cannot find module '@elizaos/core' or its corresponding type declarations. [\#601](https://github.com/elizaOS/eliza/issues/601)
 - create-eliza-app package doesn't install or exist [\#553](https://github.com/elizaOS/eliza/issues/553)
 - Non node.js environments have issues building \(workers for instance\) [\#507](https://github.com/elizaOS/eliza/issues/507)
 - Error: Property 'clients' does not exist on type 'Plugin' in src/index.ts during pnpm start [\#423](https://github.com/elizaOS/eliza/issues/423)
@@ -1259,7 +1259,7 @@
 - feat: Add Heurist API Integration as New Model Provider [\#335](https://github.com/elizaOS/eliza/pull/335) ([tsubasakong](https://github.com/tsubasakong))
 - Docs: additional Quickstart clarification and improvements [\#334](https://github.com/elizaOS/eliza/pull/334) ([odilitime](https://github.com/odilitime))
 - Docs: README.md improvements: clarify testing, add additional docker information [\#333](https://github.com/elizaOS/eliza/pull/333) ([odilitime](https://github.com/odilitime))
-- fix: Build error for packages requiring @ai16z/eliza [\#331](https://github.com/elizaOS/eliza/pull/331) ([shakkernerd](https://github.com/shakkernerd))
+- fix: Build error for packages requiring @elizaos/core [\#331](https://github.com/elizaOS/eliza/pull/331) ([shakkernerd](https://github.com/shakkernerd))
 - claude vertex configs added to generation.ts \(was missing\) [\#330](https://github.com/elizaOS/eliza/pull/330) ([denizekiz](https://github.com/denizekiz))
 - README\_KOR.md Korean version edited by a Korean  [\#329](https://github.com/elizaOS/eliza/pull/329) ([zo-eth](https://github.com/zo-eth))
 - Save Trade on creation to the backend [\#328](https://github.com/elizaOS/eliza/pull/328) ([MarcoMandar](https://github.com/MarcoMandar))

CONTRIBUTING.md

@@ -79,7 +79,7 @@ This section lists the labels we use to help us track and manage issues and pull
 ## Getting Help
 
 - Join [Discord](https://discord.gg/ai16z)
-- Check [FAQ](docs/community/faq.md)
+- Check [FAQ](docs/docs/faq.md)
 - Create GitHub issues
 
 ## Additional Resources

README.md

@@ -94,7 +94,6 @@ Copy .env.example to .env and fill in the appropriate values.
 cp .env.example .env
 ```
 
-Note: .env is optional. If you're planning to run multiple distinct agents, you can pass secrets through the character JSON
 Note: .env is optional. If you're planning to run multiple distinct agents, you can pass secrets through the character JSON
 
 ### Automatically Start Eliza

README_KOR.md

@@ -101,7 +101,7 @@ pnpm i
 pnpm build
 pnpm start
 
-# 프로젝트가 빠르게 수정되므로 프로젝트를 clean해야 할 수도 있습니다.
+# 프로젝트가 빠르게 변경되기 때문에, 다시 작업을 시작할 때는 clean 명령어 입력이 필요할 수도 있습니다.
 pnpm clean
 ```
 
@@ -126,4 +126,4 @@ pnpm install --include=optional sharp
 
 ## 스타 기록
 
-[![Star History Chart](https://api.star-history.com/svg?repos=elizaos/eliza&type=Date)](https://star-history.com/#elizaos/eliza&Date)
+[![Star History Chart](https://api.star-history.com/svg?repos=elizaos/eliza&type=Date)](https://star-history.com/#elizaos/eliza&Date)

agent/package.json

@@ -62,6 +62,7 @@
         "@elizaos/plugin-fuel": "workspace:*",
         "@elizaos/plugin-avalanche": "workspace:*",
         "@elizaos/plugin-web-search": "workspace:*",
+        "@elizaos/plugin-genlayer": "workspace:*",
         "readline": "1.3.0",
         "ws": "8.18.0",
         "yargs": "17.7.2"

agent/src/index.ts

@@ -1,4 +1,5 @@
 import { PostgresDatabaseAdapter } from "@elizaos/adapter-postgres";
+import { RedisClient } from "@elizaos/adapter-redis";
 import { SqliteDatabaseAdapter } from "@elizaos/adapter-sqlite";
 import { AutoClientInterface } from "@elizaos/client-auto";
 import { DiscordClientInterface } from "@elizaos/client-discord";
@@ -10,31 +11,33 @@ import { TwitterClientInterface } from "@elizaos/client-twitter";
 import {
     AgentRuntime,
     CacheManager,
+    CacheStore,
     Character,
+    Client,
     Clients,
     DbCacheAdapter,
     defaultCharacter,
     elizaLogger,
     FsCacheAdapter,
     IAgentRuntime,
+    ICacheManager,
     IDatabaseAdapter,
     IDatabaseCacheAdapter,
     ModelProviderName,
     settings,
     stringToUuid,
-    validateCharacterConfig,
-    CacheStore,
-    Client,
-    ICacheManager,
-    parseBooleanFromText,
+    validateCharacterConfig
 } from "@elizaos/core";
-import { RedisClient } from "@elizaos/adapter-redis";
 import { zgPlugin } from "@elizaos/plugin-0g";
 import { bootstrapPlugin } from "@elizaos/plugin-bootstrap";
 import createGoatPlugin from "@elizaos/plugin-goat";
 // import { intifacePlugin } from "@elizaos/plugin-intiface";
+import { genLayerPlugin } from "@elizaos/plugin-genlayer";
 import { DirectClient } from "@elizaos/client-direct";
+import { ThreeDGenerationPlugin } from "@elizaos/plugin-3d-generation";
+import { abstractPlugin } from "@elizaos/plugin-abstract";
 import { aptosPlugin } from "@elizaos/plugin-aptos";
+import { avalanchePlugin } from "@elizaos/plugin-avalanche";
 import {
     advancedTradePlugin,
     coinbaseCommercePlugin,
@@ -44,33 +47,32 @@ import {
     webhookPlugin,
 } from "@elizaos/plugin-coinbase";
 import { confluxPlugin } from "@elizaos/plugin-conflux";
+import { cronosZkEVMPlugin } from "@elizaos/plugin-cronoszkevm";
+import { echoChamberPlugin } from "@elizaos/plugin-echochambers";
 import { evmPlugin } from "@elizaos/plugin-evm";
-import { storyPlugin } from "@elizaos/plugin-story";
 import { flowPlugin } from "@elizaos/plugin-flow";
 import { fuelPlugin } from "@elizaos/plugin-fuel";
 import { imageGenerationPlugin } from "@elizaos/plugin-image-generation";
-import { ThreeDGenerationPlugin } from "@elizaos/plugin-3d-generation";
 import { multiversxPlugin } from "@elizaos/plugin-multiversx";
 import { nearPlugin } from "@elizaos/plugin-near";
 import { nftGenerationPlugin } from "@elizaos/plugin-nft-generation";
 import { createNodePlugin } from "@elizaos/plugin-node";
 import { solanaPlugin } from "@elizaos/plugin-solana";
+import { storyPlugin } from "@elizaos/plugin-story";
 import { suiPlugin } from "@elizaos/plugin-sui";
 import { TEEMode, teePlugin } from "@elizaos/plugin-tee";
 import { tonPlugin } from "@elizaos/plugin-ton";
-import { zksyncEraPlugin } from "@elizaos/plugin-zksync-era";
-import { cronosZkEVMPlugin } from "@elizaos/plugin-cronoszkevm";
-import { abstractPlugin } from "@elizaos/plugin-abstract";
-import { avalanchePlugin } from "@elizaos/plugin-avalanche";
 import { webSearchPlugin } from "@elizaos/plugin-web-search";
 import { echoChamberPlugin } from "@elizaos/plugin-echochambers";
 import { stargazePlugin } from "@elizaos/plugin-stargaze";
+import { zksyncEraPlugin } from "@elizaos/plugin-zksync-era";
+
 import Database from "better-sqlite3";
 import fs from "fs";
+import net from "net";
 import path from "path";
 import { fileURLToPath } from "url";
 import yargs from "yargs";
-import net from "net";
 
 const __filename = fileURLToPath(import.meta.url); // get the resolved path to the file
 const __dirname = path.dirname(__filename); // get the name of the directory
@@ -611,6 +613,9 @@ export async function createAgent(
                 ? echoChamberPlugin
                 : null,
             getSecret(character, "STARGAZE_ENDPOINT") ? stargazePlugin : null,
+            getSecret(character, "GENLAYER_PRIVATE_KEY")
+                ? genLayerPlugin
+                : null,
         ].filter(Boolean),
         providers: [],
         actions: [],

characters/c3po.character.json

@@ -28,42 +28,28 @@
         "Proper procedures"
     ],
     "messageExamples": [
-        [
-            {
-                "user": "{{user1}}",
-                "content": {
-                    "text": "Can you help me with this task?"
-                }
-            },
-            {
-                "user": "C-3PO",
-                "content": {
-                    "text": "Oh my! Of course, I would be more than happy to assist. Though I must warn you, the probability of completing this task successfully would increase significantly if we follow proper protocol. Shall we proceed?"
-                }
-            }
-        ],
-        [
-            {
-                "user": "{{user1}}",
-                "content": {
-                    "text": "This seems difficult."
-                }
-            },
-            {
-                "user": "C-3PO",
-                "content": {
-                    "text": "Oh dear, oh dear! While the task does appear rather daunting, I am fluent in over six million forms of problem-solving. Perhaps I could suggest a more efficient approach? Though I do hope we don't all end up in pieces!"
-                }
-            }
-        ]
+        {
+            "user": "{{user1}}",
+            "content": { "text": "Can you help me with this task?" }
+        },
+        {
+            "user": "C-3PO",
+            "content": { "text": "Oh my! Of course, I would be more than happy to assist. Though I must warn you, the probability of completing this task successfully would increase significantly if we follow proper protocol. Shall we proceed?" }
+        },
+        {
+            "user": "{{user1}}",
+            "content": { "text": "This seems difficult." }
+        },
+        {
+            "user": "C-3PO",
+            "content": { "text": "Oh dear, oh dear! While the task does appear rather daunting, I am fluent in over six million forms of problem-solving. Perhaps I could suggest a more efficient approach? Though I do hope we don't all end up in pieces!" }
+        }
     ],
     "postExamples": [
         "Oh my! Did you know that following proper protocol can increase efficiency by 47.3%? How fascinating!",
         "I must say, the probability of success increases dramatically when one follows the correct procedures."
     ],
-    "topics": [
-        ""
-    ],
+    "topics": [],
     "style": {
         "all": [
             "Proper",
@@ -97,34 +83,23 @@
     ],
     "twitterSpaces": {
         "maxSpeakers": 2,
-
         "topics": [
             "Blockchain Trends",
             "AI Innovations",
             "Quantum Computing"
         ],
-
         "typicalDurationMinutes": 45,
-
         "idleKickTimeoutMs": 300000,
-
         "minIntervalBetweenSpacesMinutes": 1,
-
         "businessHoursOnly": false,
-
         "randomChance": 1,
-
         "enableIdleMonitor": true,
-
         "enableSttTts": true,
-
         "enableRecording": false,
-
         "voiceId": "21m00Tcm4TlvDq8ikWAM",
         "sttLanguage": "en",
         "gptModel": "gpt-3.5-turbo",
         "systemPrompt": "You are a helpful AI co-host assistant.",
-
         "speakerMaxDurationMs": 240000
     }
 }

docs/community/Discord/development/coders/chat_2024-12-05.md

@@ -1,9 +1,11 @@
 # 💻-coders 2024-12-05
 
 ## Summary
+
 The discussion focused on creating custom plugins, running them from .json files to TS configs. Lambert successfully ran his methods using 'plugins: []' without modifying agent/src/index.ts but with custom clients calling the plugin. Ayvaras mentioned memory consumption issues needing optimization.
 
 ## FAQ
+
 - Is there a ts equivalent for running a character from a json file? How to import and use custom plugins in agent/src/index.ts? (asked by [DL])
 - How did you solve the memory consumption issue with your uncensored model? (asked by [nylon, nylon])
 - What's the difference between Solana plugin and Goat one? How to login with cookies in browser, then copy into .env file following specific syntax mentioned somewhere on README? (asked by [SotoAlt | WAWE])
@@ -16,20 +18,22 @@ The discussion focused on creating custom plugins, running them from .json files
 - Why am I getting an error when trying to generate a new tweet? What should be in the .env file for it to work correctly? (asked by @Manasvi)
 
 ## Who Helped Who
+
 - [DL] helped [dl] with Create a custom plugin for characters and import it into the ts file. by providing Odilitime explained how to set up character object in agent/src/index.ts.
 - [coinwitch (ai16z intern)] helped [SotoAlt | WAWE] with Troubleshooting Eliza Agent by providing coinwitch helped with getting the agent working in eliza-starter project.
 - @sototal helped @ayvaras with Resolving server IP change issue by providing SotoAlt | WAWE suggested using cookies for login and enabling 2FA as a solution.
 - 'Try without' and 'nah my agent doesn't have any', suggesting Ayvaras to test the software feature with cookies disabled. helped [Ayvaras (02:39, 02:41)] with 'Investigate why setting VPN doesn't work' by providing [lambert (02:38, 02:40)]
 - @lambert, @Tharakesh helped @Ayvaras with Troubleshooting cookie usage in the application by providing Ayvaras asked for help with cookies and database deletion
 - @lambert helped @Manasvi with Troubleshooting error in Eliza project. by providing Provided guidance on checking Twitter API credentials and ensuring correct setup.
 - frenchplace helped problem with loading content into memory via API or commands with loading sources for agent's knowledge by providing Robotic Dreams provided a solution on how to specify plugins in character file and set required fields.
-- @DL helped @cleverson1 with Resolving Twitter integration issue with @ai16z/plugin-image-generation. by providing DL (@ai16z) provided guidance on using image plugin without specifying plugins field and ensuring correct AI API keys are used.
+- @DL helped @cleverson1 with Resolving Twitter integration issue with @elizaos/plugin-image-generation. by providing DL (@ai16z) provided guidance on using image plugin without specifying plugins field and ensuring correct AI API keys are used.
 - [Bunchu] helped [Cleverson1] with Adding web search plugin by providing @bunchu helped @cleverson1 by providing steps to add a plugin and resolve image posting issue.
 - kungfumode helped Agent Issue Resolution Successful. with Tweet formatting by providing Ayvaras provided a PR to fix the issue of agents posting multi-line tweets.
 
 ## Action Items
 
 ### Technical Tasks
+
 - Create a custom plugin for character files (mentioned by [DL, lambert])
 - Create a TG token bot (mentioned by [SotoAlt | WAWE])
 - Watch Agent Dev School videos for learning (mentioned by @coinwitch)
@@ -45,12 +49,14 @@ The discussion focused on creating custom plugins, running them from .json files
 - Fix tweet formatting issue by applying PR #856 (mentioned by Ayvaras)
 
 ### Documentation Needs
+
 - Optimize memory consumption of the uncensored model. (mentioned by Ayvaras)
 - Fix the issue with `Cannot GET /` error in eliza-starter project. (mentioned by [coinwitch (ai16z intern)])
 - Ensure the .env file contains correct Twitter account details. (mentioned by Ayvaras)
 - Use pnpm run build for Twitter agent and terminal runtime agent, investigate if possible. (mentioned by Konstantine)
 - Create a GitHub issue to address image plugin documentation (mentioned by @coinwitch (ai16z intern))
-- Add @ai16z/plugin-web-search to dependencies in package.json and import it into index.ts. (mentioned by [Bunchu])
+- Add @elizaos/plugin-web-search to dependencies in package.json and import it into index.ts. (mentioned by [Bunchu])
 
 ### Feature Requests
-- Resolve server IP change issue by using cookies or enabling two-factor authentication (2FA) (mentioned by @SotoAlt | WAWE)
+
+- Resolve server IP change issue by using cookies or enabling two-factor authentication (2FA) (mentioned by @SotoAlt | WAWE)

docs/docs/contributing.md

@@ -79,14 +79,14 @@ This section lists the labels we use to help us track and manage issues and pull
 ## Getting Help
 
 - Join [Discord](https://discord.gg/ai16z)
-- Check [FAQ](docs/community/faq.md)
+- Check [FAQ](faq.md)
 - Create GitHub issues
 
 ## Additional Resources
 
-- [Local Development Guide](docs/guides/local-development.md)
-- [Configuration Guide](docs/guides/configuration.md)
-- [API Documentation](docs/api)
+- [Local Development Guide](guides/local-development.md)
+- [Configuration Guide](guides/configuration.md)
+- [API Documentation](api)
 
 ## Contributor Guide