A successful operation will yield zero or more effects. These effects
represent specific changes that occur in the ledger, but are not necessarily
directly reflected in the ledger or history, as transactions and operations are.
Effect types
We can distinguish 6 effect groups:
- Account effects
- Signer effects
- Trustline effects
- Trading effects
- Data effects
- Misc effects
Account effects
Type |
Operation |
Account Created |
create_account |
Account Removed |
merge_account |
Account Credited |
create_account, payment, path_payment, merge_account |
Account Debited |
create_account, payment, path_payment, merge_account |
Account Thresholds Updated |
set_options |
Account Home Domain Updated |
set_options |
Account Flags Updated |
set_options |
Account Inflation Destination Updated |
set_options |
Signer effects
Type |
Operation |
Signer Created |
set_options |
Signer Removed |
set_options |
Signer Updated |
set_options |
Trustline effects
Type |
Operation |
Trustline Created |
change_trust |
Trustline Removed |
change_trust |
Trustline Updated |
change_trust, allow_trust |
Trustline Authorized |
allow_trust |
Trustline Deauthorized |
allow_trust |
Trading effects
Type |
Operation |
Offer Created |
manage_offer, create_passive_offer |
Offer Removed |
manage_offer, create_passive_offer, path_payment |
Offer Updated |
manage_offer, create_passive_offer, path_payment |
Trade |
manage_offer, create_passive_offer, path_payment |
Data effects
Type |
Operation |
Data Created |
manage_data |
Data Removed |
manage_data |
Data Updated |
manage_data |
Misc effects
Type |
Operation |
Sequence Bumped |
bump_sequence |
Attributes
Attributes depend on effect type.
Links
rel |
Example |
Relation |
self |
/effects?order=asc\u0026limit=1 |
|
prev |
/effects?order=desc\u0026limit=1\u0026cursor=141733924865-1 |
|
next |
/effects?order=asc\u0026limit=1\u0026cursor=141733924865-1 |
|
operation |
/operations/141733924865 |
Operation that created the effect |
Example
{
"_embedded": {
"records": [
{
"_links": {
"operation": {
"href": "/operations/141733924865"
},
"precedes": {
"href": "/effects?cursor=141733924865-1\u0026order=asc"
},
"succeeds": {
"href": "/effects?cursor=141733924865-1\u0026order=desc"
}
},
"account": "GBS43BF24ENNS3KPACUZVKK2VYPOZVBQO2CISGZ777RYGOPYC2FT6S3K",
"paging_token": "141733924865-1",
"starting_balance": "10000000.0",
"type_i": 0,
"type": "account_created"
}
]
},
"_links": {
"next": {
"href": "/effects?order=asc\u0026limit=1\u0026cursor=141733924865-1"
},
"prev": {
"href": "/effects?order=desc\u0026limit=1\u0026cursor=141733924865-1"
},
"self": {
"href": "/effects?order=asc\u0026limit=1\u0026cursor="
}
}
}
Endpoints
Edit this doc in GitHub