From 5889e82b7332e691f47a9de602e2137d37e11c21 Mon Sep 17 00:00:00 2001
From: Sayo <82053242+wtfsayo@users.noreply.github.com>
Date: Tue, 11 Nov 2025 19:09:06 -0300
Subject: [PATCH 1/4] Add tokenomics page with contract addresses, vesting
schedules, and token release information
- Created new tokenomics.mdx page with comprehensive token information
- Added tokenomics page to sidebar navigation under Getting Started
- Added prominent banner card on home page linking to tokenomics
- Includes contract addresses for SVM and EVM chains
- Documents vesting schedules for all allocations
- Details token release schedule and migration from ai16z
---
docs.json | 3 +-
index.mdx | 9 ++++++
tokenomics.mdx | 77 ++++++++++++++++++++++++++++++++++++++++++++++++++
3 files changed, 88 insertions(+), 1 deletion(-)
create mode 100644 tokenomics.mdx
diff --git a/docs.json b/docs.json
index d98ae25..3d466c2 100644
--- a/docs.json
+++ b/docs.json
@@ -35,7 +35,8 @@
"index",
"installation",
"quickstart",
- "what-you-can-build"
+ "what-you-can-build",
+ "tokenomics"
]
},
{
diff --git a/index.mdx b/index.mdx
index bccf74d..d0033fd 100644
--- a/index.mdx
+++ b/index.mdx
@@ -3,6 +3,15 @@ title: Overview
description: 'Build autonomous AI agents with the most popular agentic framework'
---
+
+ Learn about $elizaOS tokenomics, contract addresses, vesting schedules, and token release details
+
+
## What is elizaOS?
elizaOS is a TypeScript framework for building AI agents that can think, learn, and act autonomously. Create agents with unique, persistent personalities, equip them with plugins to interact with the world, and let them work toward their goals independently.
diff --git a/tokenomics.mdx b/tokenomics.mdx
new file mode 100644
index 0000000..b54c9cb
--- /dev/null
+++ b/tokenomics.mdx
@@ -0,0 +1,77 @@
+---
+title: Tokenomics
+description: Key information about the $elizaOS token economics, contract addresses, vesting schedules, and token release details
+icon: coins
+---
+
+See below key information about the $elizaOS tokenomics.
+
+## Contract Addresses
+
+
+$elizaOS is available on multiple chains with cross-chain functionality enabled from day one.
+
+
+**$elizaOS SVM:** `DuMbhu7mvQvqQHGcnikDgb4XegXJRyhUBfdU22uELiZA`
+
+**$elizaOS EVM (ETH & Base & BSC):** `0xea17Df5Cf6D172224892B5477A16ACb111182478`
+
+**Token Standards:** BEP-20 (BSC), ERC-20 (Ethereum, Base) and SPL (Solana). CCIP enabled day one.
+
+**Total Supply:** 11,000,000,000
+
+**Circulating Supply:** 7,482,200,000 (as of November 11, 2025)
+
+## Vesting and Transparency
+
+All token allocations follow structured vesting schedules with built-in transparency mechanisms:
+
+
+
+ 3-month cliff + 9-month linear vest
+
+
+
+ 24-month linear vest
+
+
+
+ 12-month cliff from October 21, then 24-month linear vest (total 36 months)
+
+
+
+ Locked multisig, minimum 12-month cliff
+
+
+
+ Programmatic for market making
+
+
+
+
+**Monitoring:** All vesting wallets will be publicly listed with explorer links for real-time tracking. Streamflow contracts enforce cliffs and prevent discretionary early unlocks.
+
+
+## Token Release Schedule
+
+After the migration from $ai16z to $elizaOS, the $elizaOS total supply will gradually expand from 6.6B to 11B (+40%), with circulating supply increasing by 882M, from 6.6B to 7.4B (approximately +13%) immediately.
+
+This unlocks capital for increased liquidity demands of the token becoming multichain and funding ecosystem growth – including:
+
+- **607M tokens** for liquidity & listings
+- **275M tokens** of Protocol Owned Liquidity
+
+
+Over time, total supply could expand to up to 11B tokens, though actual circulating supply may be less as a large portion is held by the Foundation and Treasury for ecosystem development and liquidity management.
+
+
+## Change Log
+
+### v1.1 - November 11, 2025
+
+**Description:** Introduction of snapshot to $ai16z to migrate
+
+### v1.0 - November 6, 2025
+
+**Description:** Migration from $ai16z to $elizaOS started
+
From c56e16162eca2114a4ce24d993543ec525b4399d Mon Sep 17 00:00:00 2001
From: Sayo <82053242+wtfsayo@users.noreply.github.com>
Date: Wed, 12 Nov 2025 09:07:44 -0300
Subject: [PATCH 2/4] Update tokenomics change log with specific snapshot time
- Reordered change log entries (v1.0 first, then v1.1)
- Updated v1.1 description to include specific snapshot time (11:40am UTC)
- Added horizontal rule separator between entries
---
tokenomics.mdx | 10 ++++++----
1 file changed, 6 insertions(+), 4 deletions(-)
diff --git a/tokenomics.mdx b/tokenomics.mdx
index b54c9cb..e979ef8 100644
--- a/tokenomics.mdx
+++ b/tokenomics.mdx
@@ -67,11 +67,13 @@ Over time, total supply could expand to up to 11B tokens, though actual circulat
## Change Log
-### v1.1 - November 11, 2025
-
-**Description:** Introduction of snapshot to $ai16z to migrate
-
### v1.0 - November 6, 2025
**Description:** Migration from $ai16z to $elizaOS started
+---
+
+### v1.1 - November 11, 2025
+
+**Description:** Introduction of $ai16z snapshot at 11:40am UTC
+
From 2a52cb9f79590270b750234c5505ce58f0708be2 Mon Sep 17 00:00:00 2001
From: Sayo <82053242+wtfsayo@users.noreply.github.com>
Date: Wed, 12 Nov 2025 09:10:45 -0300
Subject: [PATCH 3/4] Fix token name rendering and move tokenomics to bottom of
sidebar
- Wrapped token names ($ai16z, $elizaOS) in backticks to prevent italics rendering
- Moved tokenomics page from GETTING STARTED to new TOKEN section at bottom
- Tokenomics now appears at the very bottom of the docs sidebar
---
docs.json | 9 +++++++--
tokenomics.mdx | 6 +++---
2 files changed, 10 insertions(+), 5 deletions(-)
diff --git a/docs.json b/docs.json
index 3d466c2..66a29ab 100644
--- a/docs.json
+++ b/docs.json
@@ -35,8 +35,7 @@
"index",
"installation",
"quickstart",
- "what-you-can-build",
- "tokenomics"
+ "what-you-can-build"
]
},
{
@@ -92,6 +91,12 @@
"runtime/messaging",
"runtime/sessions-api"
]
+ },
+ {
+ "group": "TOKEN",
+ "pages": [
+ "tokenomics"
+ ]
}
]
},
diff --git a/tokenomics.mdx b/tokenomics.mdx
index e979ef8..fa68171 100644
--- a/tokenomics.mdx
+++ b/tokenomics.mdx
@@ -54,7 +54,7 @@ All token allocations follow structured vesting schedules with built-in transpar
## Token Release Schedule
-After the migration from $ai16z to $elizaOS, the $elizaOS total supply will gradually expand from 6.6B to 11B (+40%), with circulating supply increasing by 882M, from 6.6B to 7.4B (approximately +13%) immediately.
+After the migration from `$ai16z` to `$elizaOS`, the `$elizaOS` total supply will gradually expand from 6.6B to 11B (+40%), with circulating supply increasing by 882M, from 6.6B to 7.4B (approximately +13%) immediately.
This unlocks capital for increased liquidity demands of the token becoming multichain and funding ecosystem growth – including:
@@ -69,11 +69,11 @@ Over time, total supply could expand to up to 11B tokens, though actual circulat
### v1.0 - November 6, 2025
-**Description:** Migration from $ai16z to $elizaOS started
+**Description:** Migration from `$ai16z` to `$elizaOS` started
---
### v1.1 - November 11, 2025
-**Description:** Introduction of $ai16z snapshot at 11:40am UTC
+**Description:** Introduction of `$ai16z` snapshot at 11:40am UTC
From 439194474f0c32b9e01f4468423edc7c2261cb1a Mon Sep 17 00:00:00 2001
From: Sayo <82053242+wtfsayo@users.noreply.github.com>
Date: Wed, 12 Nov 2025 09:11:00 -0300
Subject: [PATCH 4/4] Remove icon from tokenomics page
---
tokenomics.mdx | 1 -
1 file changed, 1 deletion(-)
diff --git a/tokenomics.mdx b/tokenomics.mdx
index fa68171..74780d8 100644
--- a/tokenomics.mdx
+++ b/tokenomics.mdx
@@ -1,7 +1,6 @@
---
title: Tokenomics
description: Key information about the $elizaOS token economics, contract addresses, vesting schedules, and token release details
-icon: coins
---
See below key information about the $elizaOS tokenomics.