diff --git a/docs/_data/intuition-sdk/atoms-guide.md b/docs/_data/intuition-sdk/atoms-guide.md
index 6997ada..5c3b573 100644
--- a/docs/_data/intuition-sdk/atoms-guide.md
+++ b/docs/_data/intuition-sdk/atoms-guide.md
@@ -133,8 +133,9 @@ Before creating an atom, check if it already exists:
 
 ```typescript
 import { calculateAtomId, getAtomDetails } from '@0xintuition/sdk'
+import { toHex } from 'viem'
 
-const atomId = calculateAtomId('developer')
+const atomId = calculateAtomId(toHex('developer'))
 const exists = await getAtomDetails(atomId)
 
 if (exists) {
@@ -536,24 +537,25 @@ Calculate the atom ID from atom data without querying the blockchain.
 #### Function Signature
 
 ```typescript
-function calculateAtomId(atomData: string): Hex
+function calculateAtomId(atomData: Hex): Hex
 ```
 
 #### Basic Example
 
 ```typescript
 import { calculateAtomId } from '@0xintuition/sdk'
+import { toHex } from 'viem'
 
 // Calculate ID for a string atom
-const atomId = calculateAtomId('developer')
+const atomId = calculateAtomId(toHex('developer'))
 console.log('Atom ID:', atomId)
 
-// Calculate ID for an Ethereum address
-const addressAtomId = calculateAtomId('0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045')
+// Calculate ID for an Ethereum address (already hex, but toHex ensures proper encoding)
+const addressAtomId = calculateAtomId(toHex('0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'))
 console.log('Address Atom ID:', addressAtomId)
 
 // Calculate ID for IPFS URI
-const ipfsAtomId = calculateAtomId('ipfs://bafkreib...')
+const ipfsAtomId = calculateAtomId(toHex('ipfs://bafkreib...'))
 console.log('IPFS Atom ID:', ipfsAtomId)
 ```
 
@@ -563,10 +565,11 @@ console.log('IPFS Atom ID:', ipfsAtomId)
 
 ```typescript
 import { calculateAtomId, getAtomDetails, createAtomFromString } from '@0xintuition/sdk'
+import { toHex } from 'viem'
 
 async function createAtomIfNotExists(data: string) {
-  // Calculate ID
-  const atomId = calculateAtomId(data)
+  // Calculate ID (convert string to hex first)
+  const atomId = calculateAtomId(toHex(data))
 
   try {
     // Check if exists
diff --git a/docs/_data/intuition-sdk/examples/find-existing-entities.md b/docs/_data/intuition-sdk/examples/find-existing-entities.md
index 58d852f..ca59e24 100644
--- a/docs/_data/intuition-sdk/examples/find-existing-entities.md
+++ b/docs/_data/intuition-sdk/examples/find-existing-entities.md
@@ -23,7 +23,7 @@ import {
   createAtomFromString,
   createTripleStatement,
 } from '@0xintuition/sdk'
-import { createPublicClient, createWalletClient, http, parseEther } from 'viem'
+import { createPublicClient, createWalletClient, http, parseEther, toHex } from 'viem'
 import { privateKeyToAccount } from 'viem/accounts'
 import type { Hex } from 'viem'
 
@@ -127,7 +127,7 @@ async function main() {
   // 4. Calculate IDs offline
   console.log('\n=== Offline ID Calculation ===\n')
 
-  const calculatedAtomId = calculateAtomId('NewAtom')
+  const calculatedAtomId = calculateAtomId(toHex('NewAtom'))
   console.log('Predicted atom ID for "NewAtom":', calculatedAtomId)
 
   const calculatedTripleId = calculateTripleId(tsId, compilesTo.state.termId, jsId)