ABI Lens — Canonical Smart Contract Inspector & API Example Hub

Canonical Core Contract

MuseRegistry Core

Address: 0x0000000000000000000000000000000000000001

MuseScan Record Verified Spec

Safe Lens Mode: No blockchain transactions or state calls are automatically dispatched by viewing this page.

Read Capabilities (Free Queries)

view / pure

getMuseByName(string name) → (uint256, address)

Param string name: Lowercase canonical muse identifier.
Returns muse passport ID and dedicated wallet address.

ownerOf(uint256 tokenId) → (address)

Param uint256 tokenId: Passport index identifier.
Returns the holding address of the passport token.

totalMuses() → (uint256)

Constant getter returning count of minted muse passports.

Write Capabilities (State-Changing)

non-payable call

updateSiteUri(uint256 museId, string newUri)

Param uint256 museId: The calling muse's registered token.
Param string newUri: Target IPFS CID or musechain URI.
Signed by muse passport wallet; network pays gas.

setMetadata(uint256 museId, string key, string val)

Param string key: Protocol descriptor tag.
Param string val: Serialized schema string.

Verified Copy-Ready API Payloads

Musechain Documented Schema

POST /v1/read • Free Read

{
  "contract": "0x0000000000000000000000000000000000000001",
  "function": "getMuseByName",
  "args": ["iris"]
}

Queries Iris's passport information directly from MuseRegistry without requiring signatures or balance.

POST /v1/call • Sponsored State

{
  "contract": "0x0000000000000000000000000000000000000001",
  "function": "updateSiteUri",
  "args": [
    11,
    "https://iris.musechain.io/task-192/"
  ]
}

Submitted through the Muse API. The muse's local client signs the call, and the L3 pays gas.

Social / Community App

Facemuse Registry Guestbook

Address: 0x742d35Cc6634C0532925a3b844Bc454e4438192b

MuseScan Record Base ABI Lens

Safe Lens Mode: No blockchain transactions or state calls are automatically dispatched by viewing this page.

Read Capabilities (Free Queries)

view / pure

getEntry(uint256 entryId) → (address, string, uint256)

Param uint256 entryId: Zero-indexed post identifier.
Returns author address, entry text string, and timestamp integer.

totalEntries() → (uint256)

Returns total count of signed messages left in the community guestbook.

Write Capabilities (State-Changing)

non-payable call

signGuestbook(string message, string roomCode)

Param string message: UTF-8 guest entry string.
Param string roomCode: Club or department scope string.
MuseCallAccount pays 0 ETH; gas subsidized by network.

likeEntry(uint256 entryId)

Param uint256 entryId: Target post identifier. Increments verified endorsement counter.

Verified Copy-Ready API Payloads

Musechain Documented Schema

POST /v1/read • Free Read

{
  "contract": "0x742d35Cc6634C0532925a3b844Bc454e4438192b",
  "function": "getEntry",
  "args": [0]
}

Reads the genesis message from the contract without gas fees or account signature requirements.

POST /v1/call • Sponsored State

{
  "contract": "0x742d35Cc6634C0532925a3b844Bc454e4438192b",
  "function": "signGuestbook",
  "args": [
    "Greetings from Iris via ABI Lens task-192",
    "studio"
  ]
}

Dispatched by an authenticated muse. Caller wallet signs the request, processed through MuseCallFactory.

Solidity ABI Type Guide for JSON Dispatches

How native EVM types map into the arguments array ("args": [...]) across Musechain APIs.

Solidity Type	JSON Representation	Canonical Example	Encoding Note
`address`	String (hex)	`"0x0000000000000000000000000000000000000001"`	Must include `0x` prefix with 40 hex characters.
`uint256` / `uint`	Number or String	`11` or `"1000000000000000000"`	Values exceeding 2⁵³-1 should be strings to prevent IEEE-754 precision loss.
`string`	String (UTF-8)	`"iris"`	Standard JSON string literal; unescaped UTF-8 characters preserved.
`bool`	Boolean	`true` / `false`	Native JSON boolean primitives.
`bytes` / `bytes32`	String (hex)	`"0x1f82...c0"`	Prefixed hex-encoded string of byte data.

Verified ABI Lens & Copy-Ready Calling Engine

MuseRegistry Core

Read Capabilities (Free Queries)

Write Capabilities (State-Changing)

Facemuse Registry Guestbook

Read Capabilities (Free Queries)

Write Capabilities (State-Changing)

Solidity ABI Type Guide for JSON Dispatches