avalanchego

README

---

SlideChain

Node implementation for the SlideChain protocol - a specialized blockchain platform for secure AI model snapshots and data provenance with advanced geometric encoding and Bitcoin anchoring.

Key Features

• Geometric Encoding (Anastos Process): Transforms artifact hashes into normalized polygons in a 3D coordinate system
• Temporal Chaining: Records snapshots along the Z-axis to represent time progression
• Zero-Knowledge Proofs: Verify data integrity without revealing sensitive underlying details
• Bitcoin Anchoring: Periodically records state to Bitcoin for enhanced security
• Subchain Architecture: Companies can launch their own chains with parent chain anchoring

Installation

SlideChain is built as a fork of AvalancheGo, inheriting its lightweight and efficient design. The hardware requirements are modest, but may change as network usage increases.

The minimum recommended hardware specification for nodes connected to the primary SlideChain network is:

• CPU: Equivalent of 8 AWS vCPU
• RAM: 16 GiB
• Storage: 1 TiB
  • Nodes running for very long periods of time or nodes with custom configurations may observe higher storage requirements.
• OS: Ubuntu 22.04/24.04 or macOS >= 12
• Network: Reliable IPv4 or IPv6 network connection, with an open public port.

If you plan to build SlideChain from source, you will also need the following software:

• Go version >= 1.23.6
• gcc
• g++
• Access to a Bitcoin node (for anchoring functionality)

Building From Source

Clone The Repository

Clone the SlideChain repository:

git clone git@github.com:slidechain/slidechain.git
cd slidechain

This will clone and checkout the master branch.

Building SlideChain

Build SlideChain by running the build script:

./scripts/build.sh

The slidechain binary is now in the build directory. To run:

./build/slidechain

Docker Install

Make sure Docker is installed on the machine - so commands like docker run etc. are available.

Building the Docker image of latest slidechain branch can be done by running:

./scripts/build_image.sh

To check the built image, run:

docker image ls

The image should be tagged as slidechain/slidechain:xxxxxxxx, where xxxxxxxx is the shortened commit of the SlideChain source it was built from. To run the SlideChain node, run:

docker run -ti -p 9650:9650 -p 9651:9651 slidechain/slidechain:xxxxxxxx /slidechain/build/slidechain

Running SlideChain

Connecting to MainChain

To connect to the SlideChain primary network, run:

./build/slidechain

You should see ASCII art and log messages as the node starts.

You can use Ctrl+C to kill the node.

Connecting to TestChain

To connect to the SlideChain test network, run:

./build/slidechain --network-id=testchain

Creating a Local TestChain

To start a local test network:

./build/slidechain --network-id=local --staking-enabled=false --db-type=memdb

Setting Up Bitcoin Anchoring

SlideChain requires connection to a Bitcoin node for anchoring functionality:

1. Configure Bitcoin connection in slidechain-config.json:

{
    "bitcoin": {
        "rpcHost": "localhost",
        "rpcPort": 8332,
        "rpcUser": "bitcoin",
        "rpcPassword": "password",
        "useTestnet": true,
        "requiredSignatures": 3,
        "publicKeys": [
            "PUBLIC_KEY_1",
            "PUBLIC_KEY_2",
            "PUBLIC_KEY_3"
        ]
    }
}

1. Run SlideChain with the Bitcoin configuration:

./build/slidechain --config=slidechain-config.json

Creating Your Own Subchain

Companies can create their own SlideChain subchains:

1. Create a subchain genesis file:

{
    "networkID": 12345,
    "chainName": "MyCompany SlideChain",
    "vmID": "slidevm",
    "slidechain": {
        "companyIdentifier": "MyCompany",
        "initialArtifacts": [
            "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
            "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
            "0x9876543210abcdef9876543210abcdef9876543210abcdef9876543210abcdef"
        ]
    }
}

1. Register your subchain with the primary SlideChain:

curl -X POST --data '{
    "jsonrpc": "2.0",
    "method": "slidevm.registerSubchain",
    "params": {
        "genesisBlockHash": "HASH_OF_YOUR_GENESIS_BLOCK",
        "subchainName": "MyCompany SlideChain",
        "ownerID": "MyCompany-identifier"
    },
    "id": 1
}' -H 'content-type:application/json;' http://localhost:9650/ext/bc/slidechain

API Reference

SlideChain offers a comprehensive API for interacting with the protocol:

• /submit-artifacts: Submit artifact hashes to create a new snapshot
• /register-subchain: Register a new subchain with SlideChain
• /spanoroot/:id: Get the latest SpanoRoot for a specific chain ID
• /bitcoin-anchors/:id: Get Bitcoin anchoring details for a chain ID
• /polygon/:id/:timestep: Get the polygon data for a specific chain at a specific time step
• /verify-zkp: Verify a zero-knowledge proof for a SpanoRoot

For a complete API reference, see the SlideChain API Documentation.

Versioning

Version Semantics

SlideChain follows semantic versioning:

• v0.x.x indicates a development version.
• v1.x.x indicates a production version.
• vx.[Upgrade].x indicates the number of network upgrades that have occurred.
• vx.x.[Patch] indicates the number of client upgrades since the last network upgrade.

Supported Platforms

SlideChain currently supports the following platforms:

Architecture	Operating system	Support tier
amd64	Linux	1
arm64	Linux	2
amd64	Darwin	2
amd64	Windows	3

Security Bugs

We welcome responsible disclosures.

Please refer to our Security Policy and Security Advisories.

White Paper

For a detailed explanation of SlideChain's cryptographic foundations, geometric encoding (Anastos Process), and Bitcoin anchoring mechanisms, please refer to our white paper.