blockworks-foundation
/
solana
mirror of https://github.com/blockworks-foundation/solana.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

docs: Update language around immutable programs (#21116)

This commit is contained in:
Jon Cinque 2021-11-01 21:41:49 +01:00 committed by GitHub
parent ca51ea3e04
commit ec86ff8fb3
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 16 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
docs/src/developing/on-chain-programs/deploying.md
View File

@ -11,9 +11,13 @@ clients via a _program ID_. The program ID is an _address_ specified when
deploying and is used to reference the program in subsequent transactions. deploying and is used to reference the program in subsequent transactions.
Upon a successful deployment the account that holds the program is marked Upon a successful deployment the account that holds the program is marked
executable and its account data become permanently immutable. If any changes executable. If the program is marked "final", its account data become permanently
are required to the program (features, patches, etc...) the new program must be immutable. If any changes are required to the finalized program (features, patches,
deployed to a new program ID. etc...) the new program must be deployed to a new program ID.
If a program is upgradeable, the account that holds the program is marked
executable, but it is possible to redeploy a new shared object to the same
program ID, provided that the program's upgrade authority signs the transaction.
The Solana command line interface supports deploying programs, for more The Solana command line interface supports deploying programs, for more
information see the [`deploy`](cli/usage.md#deploy-program) command line usage information see the [`deploy`](cli/usage.md#deploy-program) command line usage

8
docs/src/developing/programming-model/accounts.md
View File

@ -47,9 +47,11 @@ instruction's [program id](transactions.md#program-id). Accounts are marked as
executable during a successful program deployment process by the loader that executable during a successful program deployment process by the loader that
owns the account. When a program is deployed to the execution engine (BPF deployment), owns the account. When a program is deployed to the execution engine (BPF deployment),
the loader determines that the bytecode in the account's data is valid. the loader determines that the bytecode in the account's data is valid.
If so, the loader If so, the loader permanently marks the program account as executable.
permanently marks the program account as executable. Once executable, the
runtime enforces that the account's data (the program) is immutable. If a program is marked as final (non-upgradeable), the runtime enforces that the
account's data (the program) is immutable. Through the upgradeable loader, it is
possible to upload a totally new program to an existing program address.
## Creating ## Creating

6
docs/src/developing/programming-model/calling-between-programs.md
View File

@ -84,8 +84,10 @@ signers and writable accounts. For example, if the instruction the caller is
processing contains a signer or writable account, then the caller can invoke an processing contains a signer or writable account, then the caller can invoke an
instruction that also contains that signer and/or writable account. instruction that also contains that signer and/or writable account.
This privilege extension relies on the fact that programs are immutable. In the This privilege extension relies on the fact that programs are immutable, except
case of the `acme` program, the runtime can safely treat the transaction's during the special case of program upgrades.
In the case of the `acme` program, the runtime can safely treat the transaction's
signature as a signature of a `token` instruction. When the runtime sees the signature as a signature of a `token` instruction. When the runtime sees the
`token` instruction references `alice_pubkey`, it looks up the key in the `acme` `token` instruction references `alice_pubkey`, it looks up the key in the `acme`
instruction to see if that key corresponds to a signed account. In this case, it instruction to see if that key corresponds to a signed account. In this case, it