UOMI is an interoperable blockchain platform designed for the Polkadot and Ethereum ecosystems, supporting both Wasm and EVM smart contracts. This guide will help you quickly get up to speed with the core components of our platform.

Whether you're managing accounts, deploying smart contracts, you'll find all the essential information here to start building with UOMI. Dive into a new era of decentralized, AI-driven economic agents and explore the limitless possibilities of our innovative blockchain ecosystem!

UOMI is a Layer 1 blockchain specialized for:

• Executing all types of smart contracts

• Providing a hybrid EVM + Wasm environment with interoperability

• Seamlessly aggregating features and assets within its ecosystem

• Running AI-driven economic agents

Understanding the Architecture

UOMI is built with Substrate, inheriting many of its powerful features, including its account system. At its core, UOMI leverages Substrate's technology stack while operating as an independent Layer 1 blockchain.

Core Components

At a high level, a UOMI node provides a layered environment with two main elements:

1. An outer node that handles:

   • Network activity and peer discovery

   • Transaction request management

   • Consensus mechanisms

FRAME

FRAME (Framework for Runtime Aggregation of Modularized Entities) encompasses numerous modules and support libraries that simplify runtime development. In Substrate, these modules (called pallets) offer customizable business logic for different use cases and features that you might want to include in your runtime.

The framework provides pallets for common blockchain functionalities such as:

• Staking

• Consensus

• Governance

• Uomi-engine

Smart Contract Execution

UOMI provides a robust environment for smart contract execution through two main Virtual Machine (VM) implementations:

Ethereum Virtual Machine (EVM)

The Ethereum Virtual Machine (EVM) is a virtual computer with components that enable network participants to store data and agree on the state of that data. In UOMI, the core responsibilities of the EVM are implemented in the EVM pallet, which is responsible for executing Ethereum contract bytecode written in high-level languages like Solidity. UOMI EVM provides a fully Ethereum Virtual Machine compatible platform, which you can learn more about in the .

Substrate Virtual Machine for Wasm Contracts

UOMI includes the pallet-contracts module for WebAssembly (Wasm) smart contracts. This implementation supports the execution of Wasm-based smart contracts, providing an alternative to traditional EVM-based contracts. The Wasm environment offers several advantages, including:

• Improved performance

• Enhanced security features

• Greater language flexibility

You can learn more about Wasm contract development in the .

Hybrid Approach

One of UOMI's key features is its hybrid approach to smart contract execution, allowing developers to choose between EVM and Wasm environments based on their specific needs. This flexibility enables:

• Cross-contract interactions between EVM and Wasm

• Optimization of different use cases

• Broader ecosystem compatibility

Proof of Stake Consensus

Overview

UOMI blockchain implements a Proof of Stake (PoS) consensus mechanism utilizing BABE (Blind Assignment for Blockchain Extension) for block production. This consensus mechanism provides a secure, energy-efficient, and scalable foundation for the network.

How It Works

Stake-Based Validation

• Validators are selected based on their UOMI token stake in the network

• Higher stakes increase the probability of being chosen to produce blocks

• Participants must meet minimum staking requirements to become validators

BABE Block Production

• Utilizes a slot-based block production system

• Random validator selection for each slot using VRF (Verifiable Random Function)

• Ensures predictable block times while maintaining security

• Prevents manipulation through deterministic selection process

Network Security

Economic Security

• Validators must stake tokens as collateral

• Malicious behavior results in stake slashing

• Economic incentives align validator interests with network health

Benefits

Efficiency

• Significantly lower energy consumption compared to Proof of Work

• Faster transaction finality

• Reduced hardware requirements for participation

Scalability

• Supports high transaction throughput

• Flexible validator set size

• Efficient block production and validation process

Decentralization

• Encourages broad participation through staking

• Democratic validator selection process

• Reduced barriers to entry compared to mining

Participation

Becoming a Validator

• Meet minimum stake requirements

• Run validator node infrastructure

• Maintain high uptime and performance

• Follow network protocols and updates

Staking as a Delegate

• Participate in network security without running infrastructure

• Delegate tokens to trusted validators

• Earn proportional rewards from validation activities

This consensus mechanism forms the foundation of UOMI's reliable and efficient blockchain infrastructure, enabling secure operation of AI models and agent interactions while maintaining network decentralization.

Agents are a core concept within the UOMI blockchain, representing autonomous entities that perform operations directly on the network. These agents are designed to leverage AI models to process data, execute computations, and interact with the blockchain ecosystem seamlessly. By integrating intelligent behavior with decentralized technology, agents become powerful tools capable of executing complex tasks efficiently.

An agent’s role extends beyond computation. It has the capability to trigger transactions on the blockchain, enabling it to manage digital assets, interact with smart contracts, and coordinate activities within the decentralized environment. This level of autonomy allows agents to operate as independent entities, driving the execution of on-chain operations without requiring constant human intervention.

Agents are tightly integrated into the UOMI infrastructure, functioning as the active participants that bridge AI capabilities with blockchain processes. They embody the intelligence of the network, processing inputs deterministically to ensure consistency across all nodes. By combining autonomy, intelligence, and decentralization, agents play a pivotal role in realizing UOMI’s vision of an AI-powered blockchain ecosystem.

Security is a fundamental aspect of the UOMI platform, designed to safeguard the integrity and reliability of its decentralized ecosystem. This section introduces the core security principles and mechanisms that ensure the platform's resilience against potential threats.

Through innovative technologies and protocols, UOMI addresses critical areas such as computation, data integrity, and Model updates Integrity, laying a solid foundation for a secure and trustworthy environment. Explore how these robust security measures work together to protect the platform and its participants.

Overview

AI Models are a fundamental component of the UOMI blockchain infrastructure, enabling the execution of complex operations that power the entire ecosystem. These models encompass a wide variety of architectures supporting different tasks, including:

• Natural language processing

• Image generation

• Data analysis

• Other AI-driven applications

Integration and Features

The direct integration of AI models into the chain's infrastructure provides a seamless platform for autonomous and intelligent computations. Key features include:

• Open Source: The models used within the UOMI ecosystem are primarily open-source, ensuring transparency and adaptability.

• Deterministic Execution: To maintain consistency across the network, models are managed deterministically, ensuring that every node:

  • Processes the same input data

  • Produces identical outputs

Role in the Ecosystem

AI models in UOMI are responsible for driving the intelligence behind agent interactions. Their role includes:

• Processing input data

• Generating meaningful outputs

• Performing necessary computations for on-chain operations

This tight integration between AI and blockchain creates a robust environment where autonomous agents can operate effectively, leveraging the power of advanced AI technologies across diverse use cases.

The Model Updates Integrity system ensures seamless and secure transitions between different AI model versions, maintaining the reliability of AI operations across the UOMI network. This process is critical for guaranteeing that AI agents run the appropriate model versions during updates, thereby safeguarding the consistency and accuracy of computations.

Key Components

TSS, or Threshold Signature Scheme, is a cryptographic protocol that enables a group of nodes to collaboratively generate a shared signature. This scheme ensures that the resulting signature is valid only if a predefined number of nodes (known as the threshold) participate in the signing process.

Key Concepts

• Shared Public Key: The group of nodes collectively holds a shared public key.

The UOMI infrastructure is the backbone of our platform, designed to support the seamless integration of AI-driven agents within a decentralized blockchain environment. This section provides an overview of the key components that power UOMI, enabling robust, secure, and efficient operations for AI models and agents.

Explore how Nodes execute AI computations, delve into the various Models utilized—ranging from large language models (LLMs) to image generation frameworks—and discover how IPFS facilitates decentralized storage. Additionally, learn about the role of Agents in driving autonomous, intelligent economic interactions across the UOMI ecosystem.

Key Participants

The success of the UOMI platform relies on the contributions of several key participants:

Overview

A Uomi Network account is composed of a private key and a public key. The public key, often referred to as the account address, is publicly accessible. The private key, on the other hand, is essential for accessing and managing the associated account. While anyone can send tokens to your public address, only the holder of the private key can access and control those tokens. Consequently, safeguarding your private key is of utmost importance.

Uomi Network is compatible with two types of virtual machines, Wasm VM and EVM, and thus employs two different account formats.

Substrate Accounts

Uomi is developed using Substrate, a framework for building blockchains, and it utilizes Substrate accounts. In Substrate-based chains, the public key is used to derive one or more public addresses. Instead of directly using the public key, Substrate enables the generation of multiple addresses and address formats for an account. This means that a single public-private key pair can be used to derive various addresses for different Substrate chains.

The private key is a cryptographically secure sequence of randomly generated numbers. For easier human readability, the private key can generate a random sequence of words known as a secret seed phrase or mnemonic.

Substrate-based chains, including Uomi, use the ss58 address format. This format is a variant of Bitcoin's Base-58-check, with some modifications. Notably, ss58 includes an address type prefix to identify the address as belonging to a specific network.

EVM Accounts

On the Uomi EVM side, Ethereum-style addresses (H160 format) are supported within the Substrate-based chain. These addresses are 42 hex characters long. Each Ethereum-style address corresponds to a private key, which can be used to sign transactions on the Ethereum side of the chain. Additionally, these addresses are mapped to a storage slot within the Substrate Balance pallet, linking them to Substrate-style addresses (H256 format).

Overview

The Finney testnet provides robust infrastructure through two dedicated RPC (Remote Procedure Call) endpoints. These endpoints serve as archive nodes, offering developers and users comprehensive access to the network's historical data and current state.

Available Endpoints

Overview

Developers can create and deploy smart contracts on Uomi Network using various programming languages, including Solidity, compatible with Ethereum smart contracts, and ink!, a Rust-based smart contract language for the Polkadot ecosystem. This compatibility ensures a seamless transition for developers from other blockchain ecosystems, fostering interoperability and encouraging the adoption of the Uomi Network.

OPOC, or Optimistic Proof of Computation, is a mechanism designed to ensure the integrity and security of computational operations that occur outside the blockchain (offchain). This approach leverages both offchain and onchain elements to provide a tamper-proof system where certain operations are validated by multiple nodes to achieve consensus.

Key Concepts

• Offchain Operations: These are processes that occur outside the blockchain environment. While they offer scalability and speed, they are susceptible to tampering by malicious nodes.

Overview

The IPFS pallet provides decentralized storage capabilities to the blockchain through integration with the InterPlanetary File System (IPFS). It manages pinning, unpinning, and retrieval of files while ensuring data persistence and availability through validator consensus.

Key Features

Pinning System

• Persistent Pins: Files that remain pinned indefinitely

• Temporary Pins: Files with an expiration block number

• Validator-based Consensus: Content becomes available when pinned by majority of validators

Pin Types

Agent Pins

• Permanent pins associated with NFT IDs

• Used for storing agent-related data

• Can be updated with new CIDs

Temporary Pins

• Time-limited storage

• Minimum duration of 28,800 blocks (approximately 1 day)

• Automatically unpinned after expiration

Core Mechanisms

Consensus Process

1. Validator Pinning:

   • Validators run offchain workers to process pin requests

   • Each validator maintains its own IPFS node

   • Files become "usable" when pinned by majority (50% + 1) of validators

Pin Lifecycle

1. Pin Request:

   • User submits CID for pinning

   • System records pin request with expiration time

2. Processing:

Storage Management

Key Storage Items

Status Tracking

• ExpirationBlockNumber: When the pin expires (0 for permanent pins)

• UsableFromBlockNumber: When content becomes available (post-majority pinning)

Operations

Pin File

• Requires minimum duration (28,800 blocks)

• Creates temporary pin with expiration

• Triggers validator pinning process

Pin Agent

• Creates permanent pin associated with NFT

• Updates existing pins if necessary

• Maintains single CID per NFT ID

Get File

• Checks pin status and expiration

• Verifies content is "usable"

• Returns file content if available

Block Processing

Inherent Data

• Each block processes pin operations

• Updates usable content status

• Removes expired pins

• Updates pin status based on validator consensus

Offchain Worker

• Runs after each block

• Processes pending pin requests

• Updates local IPFS node

• Submits pin status updates

Transaction Fees in UOMI

Overview

UOMI implements a dual fee system to support both native Substrate transactions and Ethereum-compatible operations. This hybrid approach ensures efficient resource allocation and network stability while maintaining compatibility with both ecosystems.

IPFS (InterPlanetary File System) serves as the decentralized file system for the UOMI blockchain. It is an integral component of the platform, enabling seamless storage and retrieval of files required for the execution of AI operations.

• Decentralized Storage: IPFS ensures that files are stored in a distributed network, eliminating single points of failure and improving data availability.

• Efficient File Access: AI agents require access to various files, including models and data inputs, to perform their computations. IPFS provides a robust mechanism to store and retrieve these files securely.

• Integration with UOMI: The UOMI blockchain integrates IPFS to handle files referenced by smart contracts and agents, ensuring that essential data is accessible and verifiable throughout the network.

IPFS acts as the backbone for managing the data lifecycle of AI models and inputs used by agents. By leveraging IPFS, the UOMI blockchain ensures seamless access to files for computations while maintaining their immutability to preserve data integrity. Additionally, the distributed nature of IPFS optimizes performance by efficiently spreading data across the network.

Overview

Nodes are fundamental components of the UOMI ecosystem, serving multiple critical functions including blockchain maintenance, AI computation execution, and system-wide service integration. Each node type is optimized for specific roles within the network architecture.