lang: Zero copy deserialization (#202)

.travis.yml

@@ -19,7 +19,7 @@ _examples: &examples
  - npm install -g mocha
  - npm install -g ts-mocha
  - npm install -g typescript
- - npm install -g @project-serum/anchor
+ - cd ts && yarn && yarn build && npm link && cd ../
  - npm install -g @project-serum/serum
  - npm install -g @project-serum/common
  - npm install -g @solana/spl-token
@@ -28,7 +28,7 @@ _examples: &examples
  - export PATH="/home/travis/.local/share/solana/install/active_release/bin:$PATH"
  - export NODE_PATH="/home/travis/.nvm/versions/node/v$NODE_VERSION/lib/node_modules/:$NODE_PATH"
  - yes | solana-keygen new
- - cargo install --git https://github.com/project-serum/anchor anchor-cli --locked
+ - cargo install --path $TRAVIS_BUILD_DIR/cli anchor-cli --locked
 
 jobs:
  include:
@@ -59,6 +59,7 @@ jobs:
  - pushd examples/events && anchor test && popd
  - pushd examples/cashiers-check && anchor test && popd
  - pushd examples/typescript && yarn && anchor test && popd
+ - pushd examples/zero-copy && yarn && anchor test && popd
  - <<: *examples
  name: Runs the examples 2
  script:

CHANGELOG.md

@@ -14,6 +14,8 @@ incremented for features.
 ## Features
 
 * lang: Allows one to specify multiple `with` targets when creating associated acconts ([#197](https://github.com/project-serum/anchor/pull/197)).
+* lang, ts: Add array support ([#202](https://github.com/project-serum/anchor/pull/202)).
+* lang: Zero copy deserialization for accounts ([#202](https://github.com/project-serum/anchor/pull/202)).
 
 ## [0.4.3] - 2021-04-13
 

examples/zero-copy/Anchor.toml

@@ -0,0 +1,2 @@
+cluster = "localnet"
+wallet = "~/.config/solana/id.json"

examples/zero-copy/Cargo.toml

@@ -0,0 +1,4 @@
+[workspace]
+members = [
+ "programs/*"
+]

examples/zero-copy/migrations/deploy.js

@@ -0,0 +1,12 @@
+// Migrations are an early feature. Currently, they're nothing more than this
+// single deploy script that's invoked from the CLI, injecting a provider
+// configured from the workspace's Anchor.toml.
+
+const anchor = require("@project-serum/anchor");
+
+module.exports = async function (provider) {
+ // Configure client to use the provider.
+ anchor.setProvider(provider);
+
+ // Add your deploy script here.
+}

examples/zero-copy/programs/zero-copy/Cargo.toml

@@ -0,0 +1,18 @@
+[package]
+name = "zero-copy"
+version = "0.1.0"
+description = "Created with Anchor"
+edition = "2018"
+
+[lib]
+crate-type = ["cdylib", "lib"]
+name = "zero_copy"
+
+[features]
+no-entrypoint = []
+no-idl = []
+cpi = ["no-entrypoint"]
+default = []
+
+[dependencies]
+anchor-lang = { path = "../../../../lang" }

examples/zero-copy/programs/zero-copy/Xargo.toml

@@ -0,0 +1,2 @@
+[target.bpfel-unknown-unknown.dependencies.std]
+features = []

examples/zero-copy/programs/zero-copy/src/lib.rs

@@ -0,0 +1,144 @@
+//! This example demonstrates the use of zero copy deserialization for accounts.
+//! The main noticeable benefit one achieves using zero copy is the ability
+//! to create accounts larger than the size of the stack or heap, as is
+//! demonstrated by the event queue in this example.
+
+use anchor_lang::prelude::*;
+
+#[program]
+pub mod zero_copy {
+ use super::*;
+
+ pub fn create_foo(ctx: Context<CreateFoo>) -> ProgramResult {
+ let foo = &mut ctx.accounts.foo.load_init()?;
+ foo.authority = *ctx.accounts.authority.key;
+ foo.set_second_authority(ctx.accounts.authority.key);
+ Ok(())
+ }
+
+ pub fn update_foo(ctx: Context<UpdateFoo>, data: u64) -> ProgramResult {
+ let mut foo = ctx.accounts.foo.load_mut()?;
+ foo.data = data;
+ Ok(())
+ }
+
+ pub fn update_foo_second(ctx: Context<UpdateFooSecond>, second_data: u64) -> ProgramResult {
+ let mut foo = ctx.accounts.foo.load_mut()?;
+ foo.second_data = second_data;
+ Ok(())
+ }
+
+ pub fn create_bar(ctx: Context<CreateBar>) -> ProgramResult {
+ let bar = &mut ctx.accounts.bar.load_init()?;
+ bar.authority = *ctx.accounts.authority.key;
+ Ok(())
+ }
+
+ pub fn update_bar(ctx: Context<UpdateBar>, data: u64) -> ProgramResult {
+ let bar = &mut ctx.accounts.bar.load_mut()?;
+ bar.data = data;
+ Ok(())
+ }
+
+ pub fn create_large_account(_ctx: Context<CreateLargeAccount>) -> ProgramResult {
+ Ok(())
+ }
+
+ pub fn update_large_account(
+ ctx: Context<UpdateLargeAccount>,
+ idx: u32,
+ data: u64,
+ ) -> ProgramResult {
+ let event_q = &mut ctx.accounts.event_q.load_mut()?;
+ event_q.events[idx as usize] = Event {
+ data,
+ from: *ctx.accounts.from.key,
+ };
+ Ok(())
+ }
+}
+
+#[derive(Accounts)]
+pub struct CreateFoo<'info> {
+ #[account(init)]
+ foo: Loader<'info, Foo>,
+ #[account(signer)]
+ authority: AccountInfo<'info>,
+ rent: Sysvar<'info, Rent>,
+}
+
+#[derive(Accounts)]
+pub struct UpdateFoo<'info> {
+ #[account(mut, has_one = authority)]
+ foo: Loader<'info, Foo>,
+ #[account(signer)]
+ authority: AccountInfo<'info>,
+}
+
+#[derive(Accounts)]
+pub struct UpdateFooSecond<'info> {
+ #[account(mut, "&foo.load()?.get_second_authority() == second_authority.key")]
+ foo: Loader<'info, Foo>,
+ #[account(signer)]
+ second_authority: AccountInfo<'info>,
+}
+
+#[derive(Accounts)]
+pub struct CreateBar<'info> {
+ #[account(associated = authority, with = foo)]
+ bar: Loader<'info, Bar>,
+ #[account(signer)]
+ authority: AccountInfo<'info>,
+ foo: Loader<'info, Foo>,
+ rent: Sysvar<'info, Rent>,
+ system_program: AccountInfo<'info>,
+}
+
+#[derive(Accounts)]
+pub struct UpdateBar<'info> {
+ #[account(mut, has_one = authority)]
+ bar: Loader<'info, Bar>,
+ #[account(signer)]
+ authority: AccountInfo<'info>,
+}
+
+#[derive(Accounts)]
+pub struct CreateLargeAccount<'info> {
+ #[account(init)]
+ event_q: Loader<'info, EventQ>,
+ rent: Sysvar<'info, Rent>,
+}
+
+#[derive(Accounts)]
+pub struct UpdateLargeAccount<'info> {
+ #[account(mut)]
+ event_q: Loader<'info, EventQ>,
+ #[account(signer)]
+ from: AccountInfo<'info>,
+}
+
+#[account(zero_copy)]
+pub struct Foo {
+ pub authority: Pubkey,
+ pub data: u64,
+ pub second_data: u64,
+ #[accessor(Pubkey)] // The `accessor` api will likely be removed.
+ pub second_authority: [u8; 32],
+}
+
+#[associated(zero_copy)]
+pub struct Bar {
+ pub authority: Pubkey,
+ pub data: u64,
+}
+
+#[account(zero_copy)]
+pub struct EventQ {
+ pub events: [Event; 25000],
+}
+
+#[zero_copy]
+pub struct Event {
+ pub from: Pubkey,
+ pub data: u64,
+}