Skip to content

Commit

Permalink
Update on-chain -> onchain (#4708)
Browse files Browse the repository at this point in the history
  • Loading branch information
jessiemongeon1 authored Sep 23, 2024
1 parent 1219a50 commit da84b62
Show file tree
Hide file tree
Showing 12 changed files with 20 additions and 20 deletions.
4 changes: 2 additions & 2 deletions design/Stable.md
Original file line number Diff line number Diff line change
Expand Up @@ -132,9 +132,9 @@ One way to store it would be in a Motoko-specific custom section;
another alternative is as a separate internal asset.
In either case, it is probably sufficient to use a textual representation.

Like for the IDL, the System would need to provide a way to extract this information from an on-chain canister.
Like for the IDL, the System would need to provide a way to extract this information from an onchain canister.

For even higher safety, [enhanced orthogonal persistence](OrthogonalPersistence.md) integrates the compatibility check in the runtime system,
For even higher safety, [enhanced orthogonal persistence](OrthogonalPersistence.md) integrates the compatibility check in the runtime system,
such that it is atomically guarded and cannot be bypassed e.g. by skipping a `dfx` stable compatibility warning.

## Upgrade Hooks
Expand Down
10 changes: 5 additions & 5 deletions design/WhitePaper.md
Original file line number Diff line number Diff line change
Expand Up @@ -370,7 +370,7 @@ becomes
```
Result.chain(g(1),
func(x) {
Result.chain(g(2),
Result.chain(g(2),
func(y) {
Result.make(f(x, y))
}
Expand Down Expand Up @@ -621,7 +621,7 @@ Note: the obvious "solution", namely storing closure environments inside the ori

#### Upgrades and Memory

The most difficult problem to solve in the programming model of the IC by far is the question of safe and robust upgrades.
The most difficult problem to solve in the programming model of the IC by far is the question of safe and robust upgrades.
For this purpose, Motoko implements powerful and safe persistence, see [Enhanced Orthogonal Persistence](OrthogonalPersistence.md).

#### Upgrades and Methods
Expand Down Expand Up @@ -666,13 +666,13 @@ Unfortunately, though, this is a more difficult problem than linking modules com
Wasm component model offers a solution for secure intra-canister language interop on the IC.


#### On-chain Linking
#### Onchain Linking

[Separate compilation](#separate-compilation) avoids the need to _compile_ applications in a monolitic manner, but it does not prevent the need to _deploy_ them in monolithic form. No matter how large an application and how small a change, upgrading always requires redeploying the entire code.

Also, it is not possible to share modules on-chain between multiple applications. For features like [unicode support](#text), it would be desirable if respective modules of the language runtime would only have to be installed on the chain once and could be shared between applications.
Also, it is not possible to share modules onchain between multiple applications. For features like [unicode support](#text), it would be desirable if respective modules of the language runtime would only have to be installed on the chain once and could be shared between applications.

Supporting this would require a new mechanism in the IC that allows canisters to consist of more than just a single Wasm module, and linking these modules _dynamically_, "on-chain", reminiscent of dynamic linking in conventional operating systems. Unfortunately, there currently isn't any mechanism planned for the IC to support that.
Supporting this would require a new mechanism in the IC that allows canisters to consist of more than just a single Wasm module, and linking these modules _dynamically_, "onchain", reminiscent of dynamic linking in conventional operating systems. Unfortunately, there currently isn't any mechanism planned for the IC to support that.


### Platform Support
Expand Down
2 changes: 1 addition & 1 deletion doc/md/getting-started/examples.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ Want to get started building with Motoko? Check out some of these sample project

- [Appic](https://github.com/Appic-Solutions/Auto_Investment): Automatically by and sell tokens at a specific interval or time.

- [ICDex](https://github.com/iclighthouse/ICDex): An on-chain orderbook decentralized exchange written in Motoko.
- [ICDex](https://github.com/iclighthouse/ICDex): An onchain orderbook decentralized exchange written in Motoko.

- [icrc7_motoko](https://github.com/noku-team/icrc7_motoko) and - [icrc7-mo](https://github.com/PanIndustrial-Org/icrc7.mo): Motoko implementations of the ICRC-7 NFT standard.

Expand Down
2 changes: 1 addition & 1 deletion doc/md/motoko-packages/cryptography.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ sidebar_position: 1

## Mops packages for cryptography

[Mops](https://mops.one/) is an on-chain package manager for Motoko. Here are some Mops packages for cryptography functions:
[Mops](https://mops.one/) is an onchain package manager for Motoko. Here are some Mops packages for cryptography functions:

- [`ic-certification`](https://mops.one/ic-certification): Canister signatures and certifications.

Expand Down
4 changes: 2 additions & 2 deletions doc/md/motoko-packages/data-structures.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ sidebar_position: 2

## Mops packages for data structures

[Mops](https://mops.one/) is an on-chain package manager for Motoko. Here are some Mops packages for data structure implementations:
[Mops](https://mops.one/) is an onchain package manager for Motoko. Here are some Mops packages for data structure implementations:

- [`augmented-btrees`](https://mops.one/augmented-btrees): An implementation of BTree variants, most notable the B+Tree.

Expand Down Expand Up @@ -40,7 +40,7 @@ sidebar_position: 2

- [`stable-rbtree`](https://mops.one/stable-rbtree): Stable RBtree.

- [`stable-trie`](https://mops.one/stable-trie): Stable trie.
- [`stable-trie`](https://mops.one/stable-trie): Stable trie.

- [`swb`](https://mops.one/swb): Sliding window buffers featuring random access functionalities.

Expand Down
2 changes: 1 addition & 1 deletion doc/md/motoko-packages/databases.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ sidebar_position: 3

## Mops packages for databases

[Mops](https://mops.one/) is an on-chain package manager for Motoko. Here are some Mops packages for database implementations:
[Mops](https://mops.one/) is an onchain package manager for Motoko. Here are some Mops packages for database implementations:

- [`candb`](https://mops.one/candb): A flexible, performant, and scalable non-relational, multi-canister data store built for ICP.

Expand Down
2 changes: 1 addition & 1 deletion doc/md/motoko-packages/encoding.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ sidebar_position: 4

## Mops packages for encoding

[Mops](https://mops.one/) is an on-chain package manager for Motoko. Here are some Mops packages for encoding:
[Mops](https://mops.one/) is an onchain package manager for Motoko. Here are some Mops packages for encoding:

- [`candid`](https://mops.one/candid): Encoding and decode Candid bytes.

Expand Down
2 changes: 1 addition & 1 deletion doc/md/motoko-packages/http.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ sidebar_position: 5

## Mops packages for HTTP

[Mops](https://mops.one/) is an on-chain package manager for Motoko. Here are some Mops packages for HTTP and web functionalities:
[Mops](https://mops.one/) is an onchain package manager for Motoko. Here are some Mops packages for HTTP and web functionalities:

- [`assets`](https://mops.one/assets): A library for adding asset canister functionality for your canister.

Expand Down
2 changes: 1 addition & 1 deletion doc/md/motoko-packages/icrc.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ sidebar_position: 5

## Mops packages for ICRC

[Mops](https://mops.one/) is an on-chain package manager for Motoko. Here are some Mops packages for ICRC tokens:
[Mops](https://mops.one/) is an onchain package manager for Motoko. Here are some Mops packages for ICRC tokens:

- [`account`](https://mops.one/account): Implementation of ICRC-1 and ICRC-7 accounts.

Expand Down
2 changes: 1 addition & 1 deletion doc/md/motoko-packages/types-interfaces.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ sidebar_position: 6

## Mops packages for types and interfaces

[Mops](https://mops.one/) is an on-chain package manager for Motoko. Here are some Mops packages for types and interfaces:
[Mops](https://mops.one/) is an onchain package manager for Motoko. Here are some Mops packages for types and interfaces:

- [`canistergeek`](https://mops.one/canistergeek): An open-source tool for tracking your project's cycles, memory status and logs.

Expand Down
4 changes: 2 additions & 2 deletions doc/md/motoko-packages/utilities.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ sidebar_position: 7

## Mops packages for utility functions

[Mops](https://mops.one/) is an on-chain package manager for Motoko. Here are some Mops packages for utility functions:
[Mops](https://mops.one/) is an onchain package manager for Motoko. Here are some Mops packages for utility functions:

- [`backup`](https://mops.one/backup): Library for backup restore.

Expand Down Expand Up @@ -62,7 +62,7 @@ sidebar_position: 7

- [`xtended-numbers`](https://mops.one/xtended-numbers): Extended functionality for number types, such as byte encoding.

- [`xtended-random`](https://mops.one/xtended-random): Extended library for random number generation.
- [`xtended-random`](https://mops.one/xtended-random): Extended library for random number generation.

- [`xtended-text`](https://mops.one/xtended-text): Text manipulation.

Expand Down
4 changes: 2 additions & 2 deletions doc/md/writing-motoko/randomness.md
Original file line number Diff line number Diff line change
Expand Up @@ -103,7 +103,7 @@ View this example on the [Motoko Playground](https://play.motoko.org/?tag=267523
:::tip

The above solution directly uses the finite blob of 256-random bits returned by the management canister. Class `Random.Finite` uses this finite supply of bits to generate at most 256 coin flips, returning `null` when no more flips are possible.

When its current supply of bits is exhausted, the code asynchronously requests another 256-bit blob to continue the shuffle. A more efficient, and equally robust approach would be to use the first 256-bit blob as a seed to a sequential pseudo random number generator, generating an infinite, lazy stream of bits, and then complete the shuffle with a single round of communication.

:::
Expand All @@ -127,7 +127,7 @@ actor {

## Resources

- [On-chain randomness](https://internetcomputer.org/docs/current/developer-docs/smart-contracts/advanced-features/randomness)
- [Onchain randomness](https://internetcomputer.org/docs/current/developer-docs/smart-contracts/advanced-features/randomness)

- [Random base library documentation](../base/Random.md)

Expand Down

0 comments on commit da84b62

Please sign in to comment.