eth2.0-specs/specs/test_formats/operations/README.md

56 lines
2.5 KiB
Markdown
Raw Normal View History

2019-04-12 12:19:10 +00:00
# Operations tests
The different kinds of operations ("transactions") are tested individually with test handlers.
2019-05-23 09:22:10 +00:00
## Test case format
2019-04-12 12:19:10 +00:00
### `meta.yaml`
2019-05-23 09:22:10 +00:00
```yaml
description: string -- Optional description of test case, purely for debugging purposes.
Tests should use the directory name of the test case as identifier, not the description.
bls_setting: int -- see general test-format spec.
2019-05-23 09:22:10 +00:00
```
### `pre.yaml`
A YAML-encoded `BeaconState`, the state before applying the operation.
Also available as `pre.ssz`.
### `<operation-name>.yaml`
A YAML-encoded operation object, e.g. a `ProposerSlashing`, or `Deposit`.
Also available as `<operation-name>.ssz`.
### `post.yaml`
A YAML-encoded `BeaconState`, the state after applying the operation. No value if operation processing is aborted.
Also available as `post.ssz`.
2019-05-23 09:22:10 +00:00
## Condition
2019-06-10 20:16:51 +00:00
A handler of the `operations` test-runner should process these cases,
2019-05-23 09:22:10 +00:00
calling the corresponding processing implementation.
This excludes the other parts of the block-transition.
2019-05-23 09:22:10 +00:00
Operations:
| *`operation-name`* | *`operation-object`* | *`input name`* | *`processing call`* |
|-------------------------|----------------------|----------------------|--------------------------------------------------------|
| `attestation` | `Attestation` | `attestation` | `process_attestation(state, attestation)` |
| `attester_slashing` | `AttesterSlashing` | `attester_slashing` | `process_attester_slashing(state, attester_slashing)` |
2019-08-11 16:18:25 +00:00
| `block_header` | `Block` | **`block`** | `process_block_header(state, block)` |
2019-05-23 09:22:10 +00:00
| `deposit` | `Deposit` | `deposit` | `process_deposit(state, deposit)` |
| `proposer_slashing` | `ProposerSlashing` | `proposer_slashing` | `process_proposer_slashing(state, proposer_slashing)` |
| `transfer` | `Transfer` | `transfer` | `process_transfer(state, transfer)` |
| `voluntary_exit` | `VoluntaryExit` | `voluntary_exit` | `process_voluntary_exit(state, voluntary_exit)` |
2019-06-10 20:20:45 +00:00
Note that `block_header` is not strictly an operation (and is a full `Block`), but processed in the same manner, and hence included here.
2019-05-23 09:22:10 +00:00
The resulting state should match the expected `post` state, or if the `post` state is left blank,
the handler should reject the input operation as invalid.