# TEAL Opcodes

## Opcodes¶

Ops have a 'cost' of 1 unless otherwise specified.

### err¶

- Opcode: 0x00
- Pops:
*None* - Pushes:
*None* - Error. Panic immediately. This is primarily a fencepost against accidental zero bytes getting compiled into programs.

### sha256¶

- Opcode: 0x01
- Pops:
*... stack*, []byte - Pushes: []byte
- SHA256 hash of value X, yields [32]byte
**Cost**: 7

### keccak256¶

- Opcode: 0x02
- Pops:
*... stack*, []byte - Pushes: []byte
- Keccak256 hash of value X, yields [32]byte
**Cost**: 26

### sha512_256¶

- Opcode: 0x03
- Pops:
*... stack*, []byte - Pushes: []byte
- SHA512_256 hash of value X, yields [32]byte
**Cost**: 9

### ed25519verify¶

- Opcode: 0x04
- Pops:
*... stack*, {[]byte A}, {[]byte B}, {[]byte C} - Pushes: uint64
- for (data A, signature B, pubkey C) verify the signature of ("ProgData" || program_hash || data) against the pubkey => {0 or 1}
**Cost**: 1900

The 32 byte public key is the last element on the stack, preceeded by the 64 byte signature at the second-to-last element on the stack, preceeded by the data which was signed at the third-to-last element on the stack.

### +¶

- Opcode: 0x08
- Pops:
*... stack*, {uint64 A}, {uint64 B} - Pushes: uint64
- A plus B. Panic on overflow.

### -¶

- Opcode: 0x09
- Pops:
*... stack*, {uint64 A}, {uint64 B} - Pushes: uint64
- A minus B. Panic if B > A.

### /¶

- Opcode: 0x0a
- Pops:
*... stack*, {uint64 A}, {uint64 B} - Pushes: uint64
- A divided by B. Panic if B == 0.

### *¶

- Opcode: 0x0b
- Pops:
*... stack*, {uint64 A}, {uint64 B} - Pushes: uint64
- A times B. Panic on overflow.

Overflow is an error condition which halts execution and fails the transaction. Full precision is available from `mulw`

.

### <¶

- Opcode: 0x0c
- Pops:
*... stack*, {uint64 A}, {uint64 B} - Pushes: uint64
- A less than B => {0 or 1}

### >¶

- Opcode: 0x0d
- Pops:
*... stack*, {uint64 A}, {uint64 B} - Pushes: uint64
- A greater than B => {0 or 1}

### <=¶

- Opcode: 0x0e
- Pops:
*... stack*, {uint64 A}, {uint64 B} - Pushes: uint64
- A less than or equal to B => {0 or 1}

### >=¶

- Opcode: 0x0f
- Pops:
*... stack*, {uint64 A}, {uint64 B} - Pushes: uint64
- A greater than or equal to B => {0 or 1}

### &&¶

- Opcode: 0x10
- Pops:
*... stack*, {uint64 A}, {uint64 B} - Pushes: uint64
- A is not zero and B is not zero => {0 or 1}

### ||¶

- Opcode: 0x11
- Pops:
*... stack*, {uint64 A}, {uint64 B} - Pushes: uint64
- A is not zero or B is not zero => {0 or 1}

### ==¶

- Opcode: 0x12
- Pops:
*... stack*, {any A}, {any B} - Pushes: uint64
- A is equal to B => {0 or 1}

### !=¶

- Opcode: 0x13
- Pops:
*... stack*, {any A}, {any B} - Pushes: uint64
- A is not equal to B => {0 or 1}

### !¶

- Opcode: 0x14
- Pops:
*... stack*, uint64 - Pushes: uint64
- X == 0 yields 1; else 0

### len¶

- Opcode: 0x15
- Pops:
*... stack*, []byte - Pushes: uint64
- yields length of byte value X

### itob¶

- Opcode: 0x16
- Pops:
*... stack*, uint64 - Pushes: []byte
- converts uint64 X to big endian bytes

### btoi¶

- Opcode: 0x17
- Pops:
*... stack*, []byte - Pushes: uint64
- converts bytes X as big endian to uint64

`btoi`

panics if the input is longer than 8 bytes

### %¶

- Opcode: 0x18
- Pops:
*... stack*, {uint64 A}, {uint64 B} - Pushes: uint64
- A modulo B. Panic if B == 0.

### |¶

- Opcode: 0x19
- Pops:
*... stack*, {uint64 A}, {uint64 B} - Pushes: uint64
- A bitwise-or B

### &¶

- Opcode: 0x1a
- Pops:
*... stack*, {uint64 A}, {uint64 B} - Pushes: uint64
- A bitwise-and B

### ^¶

- Opcode: 0x1b
- Pops:
*... stack*, {uint64 A}, {uint64 B} - Pushes: uint64
- A bitwise-xor B

### ~¶

- Opcode: 0x1c
- Pops:
*... stack*, uint64 - Pushes: uint64
- bitwise invert value X

### mulw¶

- Opcode: 0x1d
- Pops:
*... stack*, {uint64 A}, {uint64 B} - Pushes: uint64, uint64
- A times B out to 128-bit long result as low (top) and high uint64 values on the stack

### intcblock¶

- Opcode: 0x20 {varuint length} [{varuint value}, ...]
- Pops:
*None* - Pushes:
*None* - load block of uint64 constants

`intcblock`

loads following program bytes into an array of integer constants in the evaluator. These integer constants can be referred to by `intc`

and `intc_*`

which will push the value onto the stack. Subsequent calls to `intcblock`

reset and replace the integer constants available to the script.

### intc¶

- Opcode: 0x21 {uint8 int constant index}
- Pops:
*None* - Pushes: uint64
- push value from uint64 constants to stack by index into constants

### intc_0¶

- Opcode: 0x22
- Pops:
*None* - Pushes: uint64
- push constant 0 from intcblock to stack

### intc_1¶

- Opcode: 0x23
- Pops:
*None* - Pushes: uint64
- push constant 1 from intcblock to stack

### intc_2¶

- Opcode: 0x24
- Pops:
*None* - Pushes: uint64
- push constant 2 from intcblock to stack

### intc_3¶

- Opcode: 0x25
- Pops:
*None* - Pushes: uint64
- push constant 3 from intcblock to stack

### bytecblock¶

- Opcode: 0x26 {varuint length} [({varuint value length} bytes), ...]
- Pops:
*None* - Pushes:
*None* - load block of byte-array constants

`bytecblock`

loads the following program bytes into an array of byte string constants in the evaluator. These constants can be referred to by `bytec`

and `bytec_*`

which will push the value onto the stack. Subsequent calls to `bytecblock`

reset and replace the bytes constants available to the script.

### bytec¶

- Opcode: 0x27 {uint8 byte constant index}
- Pops:
*None* - Pushes: []byte
- push bytes constant to stack by index into constants

### bytec_0¶

- Opcode: 0x28
- Pops:
*None* - Pushes: []byte
- push constant 0 from bytecblock to stack

### bytec_1¶

- Opcode: 0x29
- Pops:
*None* - Pushes: []byte
- push constant 1 from bytecblock to stack

### bytec_2¶

- Opcode: 0x2a
- Pops:
*None* - Pushes: []byte
- push constant 2 from bytecblock to stack

### bytec_3¶

- Opcode: 0x2b
- Pops:
*None* - Pushes: []byte
- push constant 3 from bytecblock to stack

### arg¶

- Opcode: 0x2c {uint8 arg index N}
- Pops:
*None* - Pushes: []byte
- push Args[N] value to stack by index

### arg_0¶

- Opcode: 0x2d
- Pops:
*None* - Pushes: []byte
- push Args[0] to stack

### arg_1¶

- Opcode: 0x2e
- Pops:
*None* - Pushes: []byte
- push Args[1] to stack

### arg_2¶

- Opcode: 0x2f
- Pops:
*None* - Pushes: []byte
- push Args[2] to stack

### arg_3¶

- Opcode: 0x30
- Pops:
*None* - Pushes: []byte
- push Args[3] to stack

### txn¶

- Opcode: 0x31 {uint8 transaction field index}
- Pops:
*None* - Pushes: any
- push field from current transaction to stack

`txn`

Fields:

Index | Name | Type | Notes |
---|---|---|---|

0 | Sender | []byte | 32 byte address |

1 | Fee | uint64 | micro-Algos |

2 | FirstValid | uint64 | round number |

3 | FirstValidTime | uint64 | Causes program to fail; reserved for future use. |

4 | LastValid | uint64 | round number |

5 | Note | []byte | |

6 | Lease | []byte | |

7 | Receiver | []byte | 32 byte address |

8 | Amount | uint64 | micro-Algos |

9 | CloseRemainderTo | []byte | 32 byte address |

10 | VotePK | []byte | 32 byte address |

11 | SelectionPK | []byte | 32 byte address |

12 | VoteFirst | uint64 | |

13 | VoteLast | uint64 | |

14 | VoteKeyDilution | uint64 | |

15 | Type | []byte | |

16 | TypeEnum | uint64 | See table below |

17 | XferAsset | uint64 | Asset ID |

18 | AssetAmount | uint64 | value in Asset's units |

19 | AssetSender | []byte | 32 byte address. Causes clawback of all value of asset from AssetSender if Sender is the Clawback address of the asset. |

20 | AssetReceiver | []byte | 32 byte address |

21 | AssetCloseTo | []byte | 32 byte address |

22 | GroupIndex | uint64 | Position of this transaction within an atomic transaction group. A stand-alone transaction is implicitly element 0 in a group of 1. |

23 | TxID | []byte | The computed ID for this transaction. 32 bytes. |

TypeEnum mapping:

Index | "Type" string | Description |
---|---|---|

0 | unknown | Unknown type. Invalid transaction. |

1 | pay | Payment |

2 | keyreg | KeyRegistration |

3 | acfg | AssetConfig |

4 | axfer | AssetTransfer |

5 | afrz | AssetFreeze |

FirstValidTime causes the program to fail. The field is reserved for future use.

### global¶

- Opcode: 0x32 {uint8 global field index}
- Pops:
*None* - Pushes: any
- push value from globals to stack

`global`

Fields:

Index | Name | Type | Notes |
---|---|---|---|

0 | MinTxnFee | uint64 | micro Algos |

1 | MinBalance | uint64 | micro Algos |

2 | MaxTxnLife | uint64 | rounds |

3 | ZeroAddress | []byte | 32 byte address of all zero bytes |

4 | GroupSize | uint64 | Number of transactions in this atomic transaction group. At least 1. |

### gtxn¶

- Opcode: 0x33 {uint8 transaction group index}{uint8 transaction field index}
- Pops:
*None* - Pushes: any
- push field to the stack from a transaction in the current transaction group

for notes on transaction fields available, see `txn`

. If this transaction is *i* in the group, `gtxn i field`

is equivalent to `txn field`

### load¶

- Opcode: 0x34 {uint8 position in scratch space to load from}
- Pops:
*None* - Pushes: any
- copy a value from scratch space to the stack

### store¶

- Opcode: 0x35 {uint8 position in scratch space to store to}
- Pops:
*... stack*, any - Pushes:
*None* - pop a value from the stack and store to scratch space

### bnz¶

- Opcode: 0x40 {0..0x7fff forward branch offset, big endian}
- Pops:
*... stack*, uint64 - Pushes:
*None* - branch if value X is not zero

The `bnz`

instruction opcode 0x40 is followed by two immediate data bytes which are a high byte first and low byte second which together form a 16 bit offset which the instruction may branch to. For a bnz instruction at `pc`

, if the last element of the stack is not zero then branch to instruction at `pc + 3 + N`

, else proceed to next instruction at `pc + 3`

. Branch targets must be well aligned instructions. (e.g. Branching to the second byte of a 2 byte op will be rejected.) Branch offsets are currently limited to forward branches only, 0-0x7fff. A future expansion might make this a signed 16 bit integer allowing for backward branches and looping.

### pop¶

- Opcode: 0x48
- Pops:
*... stack*, any - Pushes:
*None* - discard value X from stack

### dup¶

- Opcode: 0x49
- Pops:
*... stack*, any - Pushes: any, any
- duplicate last value on stack