• Stars
    star
    1,555
  • Rank 30,088 (Top 0.6 %)
  • Language
    Rust
  • License
    Other
  • Created over 3 years ago
  • Updated about 2 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Internet Computer blockchain source: the client/replica software run by nodes

The Internet Computer Protocol (ICP)

The Internet Computer is the world’s first blockchain that runs at web speed and can increase its capacity without bound. Like the Internet (which is composed of many machines adhering to TCP/IP protocol) and blockchain protocols (such as Bitcoin and Ethereum).

Resources on the Internet Computer

Network Dashboards from the community

You can observe the state of the Internet Computer’s infrastructure (Nodes, data centers, subnets) and traditional blockchain metrics (blocks/second, Token Supply, etc)

To interact with the community, check out the developer forum: https://forum.dfinity.org/

Rust implementation of the ICP

This repo contains many different pieces (including testing and other infrastructure components), but the most important one is the source code for the Rust implementation of the "replica" (read: "client" in some blockchains) that is compiled and run by the machines that together make up the Internet Computer.

DFINITY Foundation

The DFINITY Foundation is a Swiss not-for-profit organization based in Zurich, Switzerland, which oversees research centers in Palo Alto, San Francisco, and Zurich. Its goal is to further the design, development, and adoption of the Internet Computer Protocol.

Getting Started

Who should be using this code

  • If you are an app developer, and your intent is to build apps so you want a local Internet Computer replica in your machine to deploy to, you are better off using the Canister SDK written by the DFINITY Foundation. It is optimized for this and much more lightweight (less than 2 minutes to get started). It will build and run a local replica and you do not need to get into systems code to run it.

  • If you are a blockchain enthusiast, and your intent is to understand the protocol (not an implementation), you may be better off going to the Consensus protocol and IC Interface Specification. This content (by the DFINITY research team) is tailor made for understanding the protocol and design.

  • If you are a blockchain miner, you should know that the Internet Computer Protocol (while it is a blockchain) does not have the traditional mining or validating you may come to expect from blockchain projects. The Internet Computer Protocol is designed using new and novel cryptography that does not require "mining"…​ but it does require independent node providers, which may include yourself. You can of course check out the source code in this repo, but a better resource may be this: Internet Computer Wiki - For Node Providers

  • If you are an engineer looking to build a new SDK, oracle, wallet or any part that enables and improves the Internet Computer ecosystem, you should take a look at the Interface Specification which is for low-level interaction with the Internet Computer.

  • If you are a systems engineer, security engineer or cryptographer, and your intent is to see what is going on under the hood by digging through source and building this locally, then you are in the right place.

Building the code

System requirements

  • x86-64 based system (minimum: 16 GB MEM/SWAP, 100 GB available disk space)

  • Ubuntu 20.04 or newer

  • Podman

For detailed information on building IC-OS images, please refer to the IC-OS README

Alternatively, to build all IC-OS images using a simple, containerized environment, run:

$ ./gitlab-ci/container/build-ic.sh -i

To build only the binaries and canisters, use the -b and/or -c flags:

$ ./gitlab-ci/container/build-ic.sh -b -c

All built artifacts will be located in the top-level artifacts/ directory.

Verifying releases

Each release proposal includes instructions on how to verify the build reproducibility of IC-OS update images.

To verify the build reproducibility of a specific git revision, run:

$ ./gitlab-ci/tools/repro-check.sh -c <git revision>

Contributing

The Network Nervous System

Thank you for taking the time to learn more about the Internet Computer Protocol. You can contribute to either, but it is important to note that the Internet Computer is governed by a decentralized system called the Network Nervous System (NNS). You can learn more here:

Open Source Policy

The DFINITY Foundation makes the code of the Internet Computer available to the public.

This is important so that the community can review the code that defines the behaviour of the Internet Computer. Furthermore, the community will be able to build the code and verify that it derives from the same binary image that is referenced in upgrade proposals published via the Network Nervous System (NNS).

All code of the Internet Computer is be licensed under the Apache 2.0 license, except for a few components licensed under the Internet Computer Community Source License and Internet Computer Shared Community Source License which are more restrictive than the Apache 2.0 license to protect the Intellectual Property (IP) of the DFINITY Foundation.

While we adapt our development processes and security reviews for a world of developing with our code in the open, we are not accepting any pull requests at this time. For now, please join our developer community at https://forum.dfinity.org. If you discover any bugs and vulnerabilities, please follow the procedure at https://dfinity.org/vulnerability-disclosure-program/.

More Repositories

1

awesome-internet-computer

A curated list of awesome projects and resources relating to the Internet Computer Protocol
742
star
2

examples

Example applications, microservices, and code samples for the Internet Computer
JavaScript
521
star
3

motoko

Simple high-level language for writing Internet Computer canisters
OCaml
496
star
4

motoko-base

The Motoko base library
Motoko
480
star
5

internet-identity

Internet Identity, a blockchain authentication system for the Internet Computer
Rust
403
star
6

cancan

A scalable video sharing service.
TypeScript
335
star
7

candid

Candid Library for the Internet Computer
Rust
276
star
8

cdk-rs

Rust canister development kit for the Internet Computer.
Rust
198
star
9

sdk

IC SDK: a Software Development Kit for creating and managing canister smart contracts on the ICP blockchain.
Rust
167
star
10

linkedup

An open professional network.
JavaScript
155
star
11

agent-js

A collection of libraries and tools for building software around the Internet Computer, in JavaScript.
TypeScript
147
star
12

docs

Documentation for writing code for the Internet Computer
Motoko
144
star
13

agent-rs

A collection of libraries and tools for building software around the Internet Computer, in Rust.
Rust
120
star
14

vessel

The original package manager for Motoko
Rust
113
star
15

nns-dapp

The Dapp of the Internet Computer's Network Nervous System.
TypeScript
113
star
16

oisy-wallet

A browser-based, multi-chain wallet hosted on the Internet Computer
TypeScript
93
star
17

stable-structures

A collection of data structures for fearless canister upgrades.
Rust
90
star
18

portal

Internet Computer Developer Portal
TypeScript
83
star
19

ICRC-1

A fungible token standard developed by the Ledger & Tokenization working group for the IC.
Rust
81
star
20

quill

Governance & ledger toolkit for cold wallets
Rust
80
star
21

ic-js

Libraries for interfacing with the Internet Computer.
JavaScript
70
star
22

ic-repl

Rust
70
star
23

motoko-playground

Motoko playground
TypeScript
65
star
24

grant-rfps

Grant RFPs and Bounties
62
star
25

cycles-wallet

DFINITY Cycles Wallet
TypeScript
57
star
26

keysmith

Hierarchical Deterministic Key Derivation for the Internet Computer
Shell
45
star
27

rosetta-client

JavaScript
44
star
28

invoice-canister

Providing an example and simplified experience for accepting payments in smart contracts
Motoko
44
star
29

vscode-motoko

Motoko language support for VS Code.
JavaScript
42
star
30

icp-eth-starter

An advanced starter project for interacting with Ethereum on the Internet Computer (Beta)
TypeScript
40
star
31

certified-assets

A certified assets canister written in Rust.
39
star
32

bitcoin-developer-preview

A preview of the integration between Bitcoin and the Internet Computer.
Rust
38
star
33

interface-spec

IC Interface Specification
JavaScript
37
star
34

exchange-rate-canister

The exchange rate canister (XRC) makes use of the HTTP requests feature to provide exchange rates as a service to the IC.
Rust
37
star
35

bitcoin-canister

Rust
36
star
36

ic-hs

A haskell toolbox for the Internet Computer
Haskell
35
star
37

gix-components

A UI kit developed by the GIX team
Svelte
34
star
38

ic-wasm

A collection of libraries and tools for transforming Wasm canisters running on the Internet Computer
Rust
34
star
39

wg-identity-authentication

Repository of the Identity and Wallet Standards Working Group
TypeScript
32
star
40

ic-websocket-poc

Rust
31
star
41

ICRC

Repository to ICRC proposals
29
star
42

icx-proxy

A rust-based command line tool to serve as a gateway for a Internet Computer replica.
Rust
28
star
43

prettier-plugin-motoko

A code formatter for the Motoko smart contract language.
TypeScript
28
star
44

icfront

TypeScript
27
star
45

bigmap-poc

Proof of concept of an infinitely scalable data storage for the Internet Computer application, written in Rust
Rust
26
star
46

http-proxy

Proof of concept implementation of the IC HTTP Gateway Protocol that enables end-to-end secure connections with dApps being served from the internet computer.
TypeScript
23
star
47

motoko-dev-server

A live reload development server for Motoko smart contracts.
TypeScript
22
star
48

pocketic

A canister smart contract testing solution for the Internet Computer.
22
star
49

ic-docutrack

DocuTrack is a proof-of-concept dapp built on the Internet Computer for sharing and managing documents.
Svelte
22
star
50

canister-profiling

Collection of canister performance benchmarks
Rust
21
star
51

node-ic0

An easy-to-use JavaScript API for the Internet Computer.
TypeScript
19
star
52

response-verification

Client side response verification for the Internet Computer
Rust
17
star
53

vessel-package-set

The official community package-set for vessel
Dhall
17
star
54

orbit

A trustless multi-custody digital assets management platform on the Internet Computer.
Rust
17
star
55

snsdemo

Developer focused SNS deployment demo
Shell
15
star
56

node-motoko

Compile and run Motoko smart contracts in Node.js or the browser.
TypeScript
15
star
57

canbench

A benchmarking framework for canisters on the Internet Computer.
Rust
15
star
58

erc20-icp

Contracts and canisters enabling ERC20 ICP on Ethereum
Rust
13
star
59

hardware-wallet-cli

A CLI to interact with the Internet Computer App on Ledger Nano S/X devices.
JavaScript
12
star
60

pocketic-py

PocketIC Python: A Canister Testing Library for the Internet Computer
Python
11
star
61

dre

Decentralized Reliability Engineering
Rust
10
star
62

wg-governance

Repository of the governance working group
10
star
63

embed-motoko

Embed a custom Motoko code snippet in a Medium article, blog post, or webapp.
TypeScript
10
star
64

experimental-minting-tool

CLI tool for minting NFT's
Rust
10
star
65

sns-testing

Testing SNS in local testing environment
Shell
9
star
66

threshold

Threshold voting and execution for the IC
Motoko
9
star
67

sns-quill

SNS governance & ledger toolkit for cold wallets
Rust
9
star
68

motoko.rs

Motoko concrete syntax parser in Rust.
Rust
9
star
69

antora-sdk

Repo for website collaboration - antora project file and ui project files
CSS
9
star
70

getting-started

A repository for getting started on the Internet Computer
9
star
71

canpack

Package multiple libraries into one ICP canister.
TypeScript
9
star
72

miracl_core_bls12381

Rust code of https://github.com/miracl/core (miracl_core) for curve BLS 12-381.
Rust
9
star
73

icx-nns

Rust
8
star
74

rosetta-node

A passive node of the IC that can be interacted with using the Rosetta protocol
Rust
8
star
75

cycles-ledger

The cycles ledger is a global ledger canister that enables principal IDs to hold cycles.
Rust
8
star
76

dfx-extensions

Source repo for DFX extensions binaries and metadata
Rust
8
star
77

test-state-machine-client

Rust library to interact with the ic-test-state-machine
Rust
8
star
78

papi

Paid APIs
Rust
7
star
79

dfxvm

dfx version manager
Rust
7
star
80

icp-dev-env

A Docker image for a canister smart contract developer environment for ICP.
Dockerfile
7
star
81

setup-dfx

GitHub Action to set up dfx
7
star
82

ic-gamekit

C#
7
star
83

chain-fusion-signer

A canister that does nothing but sign transactions for use on other blockchains.
Rust
6
star
84

idl2json

Rust
6
star
85

cns

Chain Name System, a trustless and decentralized discoverability layer hosted directly on the Internet Computer.
Rust
6
star
86

feedback

An ICP community feedback dapp powered by Motoko.
TypeScript
6
star
87

ic-burp-extension

Java
6
star
88

ic-staking-documentation

HTML
5
star
89

icp-hello-world-motoko

A quick and easy way to develop for the Internet Computer in Motoko on macOS, Windows or Linux.
JavaScript
5
star
90

ledger-ref

The reference implementation of ICP ledger canister.
Motoko
5
star
91

formal-models

TLA+ models of various IC components and canisters
TLA
5
star
92

wasmtime-hs

Haskell bindings to the wasmtime WASM engine
Haskell
5
star
93

internet-identity-playwright

A Playwright library to simplify the integration of Internet Identity authentication in E2E tests.
TypeScript
5
star
94

nginx-modules

C
4
star
95

dfn-components

TypeScript
4
star
96

verifiable-credentials-sdk

Repository containing a set of libraries to manage the verifiable credentials in Internet Computer
Rust
4
star
97

ic-types

DEPRECATED (A rust library containing typings and utility functions dealing with the Public specification of the Internet Computer.)
Rust
4
star
98

ic-quickjs-demo

Demo of embedding QuickJS in IC
Rust
4
star
99

ic-gateway

HTTP to IC gateway service
Rust
3
star
100

icp-calculator

A calculator of fees and costs for smart contracts on the Internet Computer Protocol (ICP)
TypeScript
3
star