Skip to main content

Terminology

In Juno, we use some terms that may be unfamiliar to some. This page provides a summary of the most commonly used terms.

Account Identifier​

An "Account Identifier" is an address, serving as the textual representation of an account on the Internet Computer (ICP) ledger. It can represent an account owned by an individual or a smart contract.

Console​

The "console" refers to Juno's administration application, located at https://console.juno.build.

Controller​

Controllers are used to grant permissions to mission controls and satellites in Juno.

For more detailed information, please refer to the dedicated documentation.

Cycles​

Cycles are used to pay for infrastructure usage. Your mission control or satellite consumes cycles while it's active.

The amount of cycles available determines whether a smart contract will be active, inactive, or eventually decommissioned (deleted).

This ensures that related costs cannot surpass the amount of cycles available.

Think of cycles like prepaid mobile data:

  • Just like your mobile plan allows you to make calls and browse the internet, cycles enable your smart contracts to process computations and store data.
  • When your data (cycles) runs out, your service (smart contract) becomes inactive.
  • To keep your smart contract running smoothly, you need to top up your cycles regularly.
  • If you don’t top it up, after some time, it will be decommissioned, similar to losing your prepaid number due to prolonged inactivity.

Learn more about computation and storage costs.

Doc​

"doc" is a commonly used shorthand in Juno for a "document of the Datastore". Wherever you see the term "doc" in the codebase or documentation, it refers specifically to a document entity managed by the Datastore. This abbreviation is used for brevity and consistency throughout the project.

ICP​

The ICP token is the cryptocurrency used to pay for transactions on Juno's infrastructure.

It can also be converted into cycles, which are used to pay for computation and storage. Unlike the market price of ICP, the price of cycles remains constant, ensuring predictable costs for infrastructure usage.

Internet Identity​

Internet Identity is a decentralized authentication provider that offers a secure blockchain login experience with a user-friendly Web2 interface.

It is free and passwordless. It integrates WebAuthn for maximum compatibility and, unlike other Web3 authentication solutions, it does not require you to save a private key on your device or in an application.

Mission control​

A mission control is a dedicated smart contract designed for managing your modules. It is under your exclusive control, allowing it, for example, to hold ICP and perform various operations such as topping up your modules.

Think of it like the command center for a space mission. Just as NASA's mission control coordinates spacecraft and satellites, your mission control manages all your satellites or orbiters.

Because it can hold ICP and is only controlled by you, your mission control also functions as your wallet.

For a schematic representation, refer to the Architecture documentation page.

Modules​

A module or segment — i.e. Satellite, Mission Control, and Orbiter — refers to a smart contract compiled into WebAssembly (WASM) code and deployed on the Internet Computer with Juno.

It acts as a comprehensive entity, encompassing memory, permission checks, and other Juno abstractions. These serve as endpoints that developers and users can query for various functionalities.

A really high level schema representing a Satellite architecture

NFID​

NFID is a digital identity that provides private and secure sign-in to applications. It offers a convenient way to authenticate with third-party providers like Metamask and Google.

Orbiter​

An orbiter is the term we use to refer to the smart contract that can optionally be employed for analytics to gather valuable, anonymous insights about your users.

Principal​

Principals are generic identifiers for the console, mission controls, satellites, and users.

They consist of a public-private key pair. When displayed or used as a configuration value, the public ID of the principal is used.

Learn more about principals.

Satellite​

A satellite is a container for your application that runs entirely on-chain. It contains your project's data, storage, application bundle, and assets.

A satellite is essentially a smart contract with added capabilities.

Currently, each satellite is dedicated to a single application.

Subnet​

A subnet is like a group of smart contracts (programs) working together on the Internet Computer. These groups, or subnets, are designed to distribute the workload across the network. By having multiple subnets, the Internet Computer can handle more activity, process data faster, and ensure the system remains efficient and secure.

When you create a module, like a Satellite, it's deployed on the same subnet as the Juno Console by default: 6pbhf-qzpdk-kuqbr-pklfa-5ehhf-jfjps-zsj6q-57nrl-kzhpd-mu7hc-vae.

Communicating between modules on different subnets takes longer due to the extra steps required for coordination (about 4 additional consensus rounds in the best case). This is why placing all your interacting smart contracts on the same subnet can lead to significant performance improvements.

Think of it like a huge playground with lots of groups of kids playing different games. Each group has its own area to play, and that area is called a subnet.

If you want to play with kids in your own group, it’s super fast and easy because you’re all together. But if you want to play with a kid in a different group, it might take a little longer since you have to cross the playground to reach them.

By picking the right group (or subnet), everyone can play faster and have more fun.

Wallet​

A wallet is your secure repository for managing and storing crypto money. Your wallet is controlled exclusively by you, ensuring that no one, including Juno, can ever access it.

Think of it like a digital vault:

  • It securely stores your ICP tokens.
  • It acts as your gateway for transactions within the Juno ecosystem.
  • It allows you to top up your modules with cycles.

Because your wallet is also your mission-control and therefore a smart contract, which requires resources to stay alive, we recommend holding a reasonable amount of tokens. Think of it like a day-to-day wallet for frequent operations rather than one for savings.