Skip to main content

SnarkyJS

Table of contents

References

Namespaces

Classes

Interfaces

Type Aliases

Variables

Functions

References

PublicKey

Re-exports PublicKey

Type Aliases

DeployArgs

Ƭ DeployArgs: { verificationKey?: { data: string ; hash: string | Field } ; zkappKey?: PrivateKey } | undefined

Defined in

lib/zkapp.ts:1508


Empty

Ƭ Empty: Undefined

Defined in

lib/proof_system.ts:80

lib/proof_system.ts:81


FlexibleProvable

Ƭ FlexibleProvable<T>: Provable<T> | Struct<T>

Type parameters

Name
T

Defined in

lib/circuit_value.ts:77


FlexibleProvablePure

Ƭ FlexibleProvablePure<T>: ProvablePure<T> | StructPure<T>

Type parameters

Name
T

Defined in

lib/circuit_value.ts:78


InferProvable

Ƭ InferProvable<A>: A extends Constructor<infer U> ? A extends Provable<U> ? U : A extends Struct<U> ? U : InferProvableBase<A> : InferProvableBase<A>

Type parameters

Name
A

Defined in

bindings/lib/provable-snarky.ts:277


JsonProof

Ƭ JsonProof: Object

Type declaration

NameType
maxProofsVerified0 | 1 | 2
proofstring
publicInputstring[]
publicOutputstring[]

Defined in

lib/proof_system.ts:187


ProvableExtended

Ƭ ProvableExtended<T, TJson>: Provable<T> & ProvableExtension<T, TJson>

Type parameters

NameType
TT
TJsonany

Defined in

lib/circuit_value.ts:67


Reducer

Ƭ Reducer<Action>: Object

Type parameters

Name
Action

Type declaration

NameType
actionTypeFlexibleProvablePure<Action>

Defined in

lib/zkapp.ts:1236

lib/zkapp.ts:1580


State

Ƭ State<A>: Object

Gettable and settable state that can be checked for equality.

Type parameters

Name
A

Type declaration

NameType
assertEquals(a: A) => void
assertNothing() => void
fetch() => Promise<undefined | A>
fromAppState(appState: Field[]) => A
get() => A
getAndAssertEquals() => A
set(a: A) => void

Defined in

lib/state.ts:73

lib/state.ts:20


Struct

Ƭ Struct<T>: ProvableExtended<NonMethods<T>> & Constructor<T> & { _isStruct: true }

Type parameters

Name
T

Defined in

lib/circuit_value.ts:459

lib/circuit_value.ts:72


TransactionStatus

Ƭ TransactionStatus: "INCLUDED" | "PENDING" | "UNKNOWN"

INCLUDED: A transaction that is on the longest chain

PENDING: A transaction either in the transition frontier or in transaction pool but is not on the longest chain

UNKNOWN: The transaction has either been snarked, reached finality through consensus or has been dropped

Defined in

lib/fetch.ts:650


Undefined

Ƭ Undefined: undefined

Defined in

lib/proof_system.ts:77

lib/proof_system.ts:78


Void

Ƭ Void: undefined

Defined in

lib/proof_system.ts:82

lib/proof_system.ts:83


ZkappPublicInput

Ƭ ZkappPublicInput: Object

The public input for zkApps consists of certain hashes of the proving AccountUpdate (and its child accountUpdates) which is constructed during method execution.

For SmartContract proving, a method is run twice: First outside the proof, to obtain the public input, and once in the prover, which takes the public input as input. The current transaction is hashed again inside the prover, which asserts that the result equals the input public input, as part of the snark circuit. The block producer will also hash the transaction they receive and pass it as a public input to the verifier. Thus, the transaction is fully constrained by the proof - the proof couldn't be used to attest to a different transaction.

Type declaration

NameType
accountUpdateField
callsField

Defined in

lib/account_update.ts:1935

lib/account_update.ts:1939

Variables

Empty

Empty: ProvablePureExtended<undefined, null>

Defined in

lib/proof_system.ts:80

lib/proof_system.ts:81


Permissions

Permissions: Object

Type declaration

NameType
allImpossible() => Permissions
default() => Permissions
dummy() => Permissions
fromJSON(permissions: { access: AuthRequired ; editActionState: AuthRequired ; editState: AuthRequired ; incrementNonce: AuthRequired ; receive: AuthRequired ; send: AuthRequired ; setDelegate: AuthRequired ; setPermissions: AuthRequired ; setTiming: AuthRequired ; setTokenSymbol: AuthRequired ; setVerificationKey: AuthRequired ; setVotingFor: AuthRequired ; setZkappUri: AuthRequired }) => Permissions
fromString(permission: AuthRequired) => AuthRequired
impossible() => AuthRequired
initial() => Permissions
none() => AuthRequired
proof() => AuthRequired
proofOrSignature() => AuthRequired
signature() => AuthRequired

Defined in

lib/account_update.ts:163

lib/account_update.ts:235


Poseidon

Const Poseidon: Object

Type declaration

NameType
Spongetypeof Sponge
hash(input: Field[]) => Field
hashToGroup(input: Field[]) => { x: Field ; y: { x0: Field ; x1: Field } }
initialState() => [Field, Field, Field]
update(state: [Field, Field, Field], input: Field[]) => [Field, Field, Field]

Defined in

lib/hash.ts:43


TokenId

Const TokenId: Object

Type declaration

NameType
check(x: Field) => void
defaultField
fromFields(x: Field[], aux: any[]) => Field
toAuxiliary(x?: Field) => any[]
toFields(x: Field) => Field[]
toInput(x: Field) => { fields?: Field[] ; packed?: [Field, number][] }
derive(tokenOwner: PublicKey, parentTokenId: Field) => Field
emptyValue() => Field
fromBase58(base58: string) => Field
fromJSON(x: string) => Field
sizeInFields() => number
toBase58(t: Field) => string
toJSON(x: Field) => string

Defined in

lib/account_update.ts:602


Undefined

Undefined: ProvablePureExtended<undefined, null>

Defined in

lib/proof_system.ts:77

lib/proof_system.ts:78


Void

Void: ProvablePureExtended<void, null>

Defined in

lib/proof_system.ts:82

lib/proof_system.ts:83


ZkappPublicInput

ZkappPublicInput: ProvablePure<{ accountUpdate: Field = Field; calls: Field = Field }> & ProvableExtension<{ accountUpdate: Field = Field; calls: Field = Field }, { accountUpdate: string = Field; calls: string = Field }>

Defined in

lib/account_update.ts:1935

lib/account_update.ts:1939


isReady

isReady: Promise<undefined>

Deprecated

await isReady is no longer needed. Remove it from your code.

Defined in

snarky.d.ts:1299

Functions

Account

Account(address, tokenId?): Account

Parameters

NameType
addressPublicKey
tokenId?Field

Returns

Account

Defined in

lib/zkapp.ts:1515


MerkleWitness

MerkleWitness(height): typeof BaseMerkleWitness

Returns a circuit-compatible Witness for a specific Tree height.

Parameters

NameTypeDescription
heightnumberHeight of the Merkle Tree that this Witness belongs to.

Returns

typeof BaseMerkleWitness

A circuit-compatible Merkle Witness.

Defined in

lib/merkle_tree.ts:236


Reducer

Reducer<T, A>(reducer): ReducerReturn<A>

Type parameters

NameType
Textends FlexibleProvablePure<any>
Aextends any = InferProvable<T>

Parameters

NameType
reducerObject
reducer.actionTypeT

Returns

ReducerReturn<A>

Defined in

lib/zkapp.ts:1580


State

State<A>(): State<A>

Type parameters

Name
A

Returns

State<A>

Defined in

lib/state.ts:73


Struct

Struct<A, T, J, Pure>(type, options?): (value: T) => T & { _isStruct: true } & Pure extends true ? ProvablePure<T> : Provable<T> & { fromJSON: (x: J) => T ; toInput: (x: T) => { fields?: Field[] ; packed?: [Field, number][] } ; toJSON: (x: T) => J }

Struct lets you declare composite types for use in snarkyjs circuits.

These composite types can be passed in as arguments to smart contract methods, used for on-chain state variables or as event / action types.

Here's an example of creating a "Voter" struct, which holds a public key and a collection of votes on 3 different proposals:

let Vote = { hasVoted: Bool, inFavor: Bool };

class Voter extends Struct({
publicKey: PublicKey,
votes: [Vote, Vote, Vote]
}) {}

// use Voter as SmartContract input:
class VoterContract extends SmartContract {
\@method register(voter: Voter) {
// ...
}
}

In this example, there are no instance methods on the class. This makes Voter type-compatible with an anonymous object of the form { publicKey: PublicKey, votes: Vote[] }. This mean you don't have to create instances by using new Voter(...), you can operate with plain objects:

voterContract.register({ publicKey, votes });

On the other hand, you can also add your own methods:

class Voter extends Struct({
publicKey: PublicKey,
votes: [Vote, Vote, Vote]
}) {
vote(index: number, inFavor: Bool) {
let vote = this.votes[i];
vote.hasVoted = Bool(true);
vote.inFavor = inFavor;
}
}

In this case, you'll need the constructor to create instances of Voter. It always takes as input the plain object:

let emptyVote = { hasVoted: Bool(false), inFavor: Bool(false) };
let voter = new Voter({ publicKey, votes: Array(3).fill(emptyVote) });
voter.vote(1, Bool(true));

In addition to creating types composed of Field elements, you can also include auxiliary data which does not become part of the proof. This, for example, allows you to re-use the same type outside snarkyjs methods, where you might want to store additional metadata.

To declare non-proof values of type string, number, etc, you can use the built-in objects String, Number, etc. Here's how we could add the voter's name (a string) as auxiliary data:

class Voter extends Struct({
publicKey: PublicKey,
votes: [Vote, Vote, Vote],
fullName: String
}) {}

Again, it's important to note that this doesn't enable you to prove anything about the fullName string. From the circuit point of view, it simply doesn't exist!

Type parameters

NameType
AA
Textends unknown = InferProvable<A>
Jextends unknown = InferJson<A>
Pureextends boolean = IsPure<A>

Parameters

NameTypeDescription
typeAObject specifying the layout of the Struct
optionsObjectAdvanced option which allows you to force a certain order of object keys
options.customObjectKeys?string[]-

Returns

(value: T) => T & { _isStruct: true } & Pure extends true ? ProvablePure<T> : Provable<T> & { fromJSON: (x: J) => T ; toInput: (x: T) => { fields?: Field[] ; packed?: [Field, number][] } ; toJSON: (x: T) => J }

Class which you can extend

Defined in

lib/circuit_value.ts:459


addCachedAccount

addCachedAccount(partialAccount, graphqlEndpoint?): void

Adds an account to the local cache, indexed by a GraphQL endpoint.

Parameters

NameTypeDefault value
partialAccountPartialAccountundefined
graphqlEndpointstringnetworkConfig.minaEndpoint

Returns

void

Defined in

lib/fetch.ts:351


arrayProp

arrayProp<T>(elementType, length): (target: any, key: string) => void

Type parameters

Name
T

Parameters

NameType
elementTypeFlexibleProvable<T>
lengthnumber

Returns

fn

▸ (target, key): void

Parameters
NameType
targetany
keystring
Returns

void

Defined in

lib/circuit_value.ts:364


checkZkappTransaction

checkZkappTransaction(txnId): Promise<{ failureReason: string[] ; success: boolean = false } | { failureReason: null = null; success: boolean = true }>

Parameters

NameType
txnIdstring

Returns

Promise<{ failureReason: string[] ; success: boolean = false } | { failureReason: null = null; success: boolean = true }>

Defined in

lib/fetch.ts:498


circuitMain

circuitMain(target, propertyName, _descriptor?): any

Parameters

NameType
targetany
propertyNamestring
_descriptor?PropertyDescriptor

Returns

any

Defined in

lib/circuit.ts:272


declareMethods

declareMethods<T>(SmartContract, methodArguments): void

declareMethods can be used in place of the @method decorator to declare SmartContract methods along with their list of arguments. It should be placed after the class declaration. Here is an example of declaring a method update, which takes a single argument of type Field:

class MyContract extends SmartContract {
// ...
update(x: Field) {
// ...
}
}
declareMethods(MyContract, { update: [Field] }); // `[Field]` is the list of arguments!

Note that a method of the same name must still be defined on the class, just without the decorator.

Type parameters

NameType
Textends typeof SmartContract

Parameters

NameType
SmartContractT
methodArgumentsRecord<string, Provable<unknown>[]>

Returns

void

Defined in

lib/zkapp.ts:1566


declareState

declareState<T>(SmartContract, states): void

declareState can be used in place of the @state decorator to declare on-chain state on a SmartContract. It should be placed after the class declaration. Here is an example of declaring a state property x of type Field.

class MyContract extends SmartContract {
x = State<Field>();
// ...
}
declareState(MyContract, { x: Field });

If you're using pure JS, it's not possible to use the built-in class field syntax, i.e. the following will not work:

// THIS IS WRONG IN JS!
class MyContract extends SmartContract {
x = State();
}
declareState(MyContract, { x: Field });

Instead, add a constructor where you assign the property:

class MyContract extends SmartContract {
constructor(x) {
super();
this.x = State();
}
}
declareState(MyContract, { x: Field });

Type parameters

NameType
Textends typeof SmartContract

Parameters

NameType
SmartContractT
statesRecord<string, FlexibleProvablePure<unknown>>

Returns

void

Defined in

lib/state.ts:163


fetchAccount

fetchAccount(accountInfo, graphqlEndpoint?, «destructured»?): Promise<{ account: Account ; error: undefined } | { account: undefined ; error: FetchError }>

Gets account information on the specified publicKey by performing a GraphQL query to the specified endpoint. This will call the 'GetAccountInfo' query which fetches zkapp related account information.

If an error is returned by the specified endpoint, an error is thrown. Otherwise, the data is returned.

Parameters

NameTypeDefault valueDescription
accountInfoObjectundefined-
accountInfo.publicKeystring | PublicKeyundefined-
accountInfo.tokenId?string | Fieldundefined-
graphqlEndpointstringnetworkConfig.minaEndpointThe graphql endpoint to fetch from
«destructured»Object{}-
› timeoutundefined | numberundefined-

Returns

Promise<{ account: Account ; error: undefined } | { account: undefined ; error: FetchError }>

zkapp information on the specified account or an error is thrown

Defined in

lib/fetch.ts:131


fetchEvents

fetchEvents(accountInfo, graphqlEndpoint?, filterOptions?): Promise<{ blockHash: string = event.blockInfo.stateHash; blockHeight: UInt32 ; chainStatus: string = event.blockInfo.chainStatus; events: { data: string[] ; transactionInfo: { hash: string ; memo: string ; status: string } }[] ; globalSlot: UInt32 ; parentBlockHash: string = event.blockInfo.parentHash }[]>

Asynchronously fetches event data for an account from the Mina Archive Node GraphQL API.

Async

Throws

If the GraphQL request fails or the response is invalid.

Example

const accountInfo = { publicKey: 'B62qiwmXrWn7Cok5VhhB3KvCwyZ7NHHstFGbiU5n7m8s2RqqNW1p1wF' };
const events = await fetchEvents(accountInfo);
console.log(events);

Parameters

NameTypeDefault valueDescription
accountInfoObjectundefinedThe account information object.
accountInfo.publicKeystringundefinedThe account public key.
accountInfo.tokenId?stringundefinedThe optional token ID for the account.
graphqlEndpoint?stringnetworkConfig.archiveEndpointThe GraphQL endpoint to query. Defaults to the Archive Node GraphQL API.
filterOptions?EventActionFilterOptions{}The optional filter options object.

Returns

Promise<{ blockHash: string = event.blockInfo.stateHash; blockHeight: UInt32 ; chainStatus: string = event.blockInfo.chainStatus; events: { data: string[] ; transactionInfo: { hash: string ; memo: string ; status: string } }[] ; globalSlot: UInt32 ; parentBlockHash: string = event.blockInfo.parentHash }[]>

A promise that resolves to an array of objects containing event data, block information and transaction information for the account.

Defined in

lib/fetch.ts:820


fetchLastBlock

fetchLastBlock(graphqlEndpoint?): Promise<PreconditionBaseTypes<{ blockchainLength: { isSome: Bool ; value: { lower: UInt32 ; upper: UInt32 } } ; globalSlotSinceGenesis: { isSome: Bool ; value: { lower: UInt32 ; upper: UInt32 } } ; minWindowDensity: { isSome: Bool ; value: { lower: UInt32 ; upper: UInt32 } } ; nextEpochData: { epochLength: { isSome: Bool ; value: { lower: UInt32 ; upper: UInt32 } } ; ledger: { hash: { isSome: Bool ; value: Field } ; totalCurrency: { isSome: Bool ; value: { lower: UInt64 ; upper: UInt64 } } } ; lockCheckpoint: { isSome: Bool ; value: Field } ; seed: { isSome: Bool ; value: Field } ; startCheckpoint: { isSome: Bool ; value: Field } } ; snarkedLedgerHash: { isSome: Bool ; value: Field } ; stakingEpochData: { epochLength: { isSome: Bool ; value: { lower: UInt32 ; upper: UInt32 } } ; ledger: { hash: { isSome: Bool ; value: Field } ; totalCurrency: { isSome: Bool ; value: { lower: UInt64 ; upper: UInt64 } } } ; lockCheckpoint: { isSome: Bool ; value: Field } ; seed: { isSome: Bool ; value: Field } ; startCheckpoint: { isSome: Bool ; value: Field } } ; totalCurrency: { isSome: Bool ; value: { lower: UInt64 ; upper: UInt64 } } }>>

Fetches the last block on the Mina network.

Parameters

NameTypeDefault value
graphqlEndpointstringnetworkConfig.minaEndpoint

Returns

Promise<PreconditionBaseTypes<{ blockchainLength: { isSome: Bool ; value: { lower: UInt32 ; upper: UInt32 } } ; globalSlotSinceGenesis: { isSome: Bool ; value: { lower: UInt32 ; upper: UInt32 } } ; minWindowDensity: { isSome: Bool ; value: { lower: UInt32 ; upper: UInt32 } } ; nextEpochData: { epochLength: { isSome: Bool ; value: { lower: UInt32 ; upper: UInt32 } } ; ledger: { hash: { isSome: Bool ; value: Field } ; totalCurrency: { isSome: Bool ; value: { lower: UInt64 ; upper: UInt64 } } } ; lockCheckpoint: { isSome: Bool ; value: Field } ; seed: { isSome: Bool ; value: Field } ; startCheckpoint: { isSome: Bool ; value: Field } } ; snarkedLedgerHash: { isSome: Bool ; value: Field } ; stakingEpochData: { epochLength: { isSome: Bool ; value: { lower: UInt32 ; upper: UInt32 } } ; ledger: { hash: { isSome: Bool ; value: Field } ; totalCurrency: { isSome: Bool ; value: { lower: UInt64 ; upper: UInt64 } } } ; lockCheckpoint: { isSome: Bool ; value: Field } ; seed: { isSome: Bool ; value: Field } ; startCheckpoint: { isSome: Bool ; value: Field } } ; totalCurrency: { isSome: Bool ; value: { lower: UInt64 ; upper: UInt64 } } }>>

Defined in

lib/fetch.ts:394


fetchTransactionStatus

fetchTransactionStatus(txId, graphqlEndpoint?): Promise<TransactionStatus>

Fetches the status of a transaction.

Parameters

NameTypeDefault value
txIdstringundefined
graphqlEndpointstringnetworkConfig.minaEndpoint

Returns

Promise<TransactionStatus>

Defined in

lib/fetch.ts:625


matrixProp

matrixProp<T>(elementType, nRows, nColumns): (target: any, key: string) => void

Type parameters

Name
T

Parameters

NameType
elementTypeFlexibleProvable<T>
nRowsnumber
nColumnsnumber

Returns

fn

▸ (target, key): void

Parameters
NameType
targetany
keystring
Returns

void

Defined in

lib/circuit_value.ts:373


method

method<T>(target, methodName, descriptor): void

A decorator to use in a zkApp to mark a method as callable by anyone. You can use inside your zkApp class as:

\@method myMethod(someArg: Field) {
// your code here
}

Type parameters

NameType
Textends SmartContract<T>

Parameters

NameType
targetT & { constructor: any }
methodNamekeyof T & string
descriptorPropertyDescriptor

Returns

void

Defined in

lib/zkapp.ts:98


prop

prop(this, target, key): void

Parameters

NameType
thisany
targetany
keystring

Returns

void

Defined in

lib/circuit_value.ts:264


provable

provable<A>(typeObj, options?): ProvableExtended<InferProvable<A>, InferJson<A>>

Type parameters

Name
A

Parameters

NameType
typeObjA
options?Object
options.customObjectKeys?string[]
options.isPure?boolean

Returns

ProvableExtended<InferProvable<A>, InferJson<A>>

Defined in

bindings/lib/provable-snarky.ts:47


provablePure

provablePure<A>(typeObj, options?): ProvablePure<InferProvable<A>> & ProvableExtension<InferProvable<A>, InferJson<A>>

Type parameters

Name
A

Parameters

NameType
typeObjA
optionsObject
options.customObjectKeys?string[]

Returns

ProvablePure<InferProvable<A>> & ProvableExtension<InferProvable<A>, InferJson<A>>

Defined in

bindings/lib/provable-snarky.ts:224


public_

public_(target, _key, index): void

Parameters

NameType
targetany
_keystring | symbol
indexnumber

Returns

void

Defined in

lib/circuit.ts:224


sendZkapp

sendZkapp(json, graphqlEndpoint?, «destructured»?): Promise<[FetchResponse, undefined] | [undefined, FetchError]>

Sends a zkApp command (transaction) to the specified GraphQL endpoint.

Parameters

NameTypeDefault value
jsonstringundefined
graphqlEndpointstringnetworkConfig.minaEndpoint
«destructured»Object{}
› timeoutundefined | numberundefined

Returns

Promise<[FetchResponse, undefined] | [undefined, FetchError]>

Defined in

lib/fetch.ts:655


setArchiveGraphqlEndpoint

setArchiveGraphqlEndpoint(graphqlEndpoint): void

Sets up a GraphQL endpoint to be used for fetching information from an Archive Node.

Parameters

NameType
graphqlEndpointstring

Returns

void

Defined in

lib/fetch.ts:100


setGraphqlEndpoint

setGraphqlEndpoint(graphqlEndpoint): void

Parameters

NameType
graphqlEndpointstring

Returns

void

Defined in

lib/fetch.ts:78


setGraphqlEndpoints

setGraphqlEndpoints(«destructured»): void

Parameters

NameType
«destructured»string[]

Returns

void

Defined in

lib/fetch.ts:71


shutdown

shutdown(): Promise<undefined>

Deprecated

shutdown() is no longer needed, and is a no-op. Remove it from your code.

Returns

Promise<undefined>

Defined in

snarky.d.ts:1294


signFeePayer

signFeePayer(transactionJson, feePayerKey, «destructured»): string

Parameters

NameType
transactionJsonstring
feePayerKeystring | PrivateKey
«destructured»Object

Returns

string

Defined in

lib/zkapp.ts:1523


state

state<A>(stateType): (target: SmartContract & { constructor: any }, key: string, _descriptor?: PropertyDescriptor) => void

A decorator to use within a zkapp to indicate what will be stored on-chain. For example, if you want to store a field element some_state in a zkapp, you can use the following in the declaration of your zkapp:

@state(Field) some_state = State<Field>();

Type parameters

Name
A

Parameters

NameType
stateTypeFlexibleProvablePure<A>

Returns

fn

▸ (target, key, _descriptor?): void

Parameters
NameType
targetSmartContract & { constructor: any }
keystring
_descriptor?PropertyDescriptor
Returns

void

Defined in

lib/state.ts:87


verify

verify(proof, verificationKey): Promise<boolean>

Parameters

NameType
proofJsonProof | Proof<any, any>
verificationKeystring

Returns

Promise<boolean>

Defined in

lib/proof_system.ts:157