Minka Ledger Docs

Read an effect change

GET
/effects/{id}/changes/{change}

Authorization

AuthorizationRequiredBearer <token>

JWT signed by private key. The presence of this token is not mandatory. It becomes required through the configuration of authorization access rules that requires a token to grant access. Once sent, the token is validated for its format, signature and expiration, regardless of the presence of access rules.

In: header

Path Parameters

idRequiredstring | string

The unique identifier of the record - its luid or address.

changeRequiredinteger

The change number of the record

Minimum: 1

Header Parameters

x-ledgerstring | string

The unique identifier of ledger in context for multi tenant requests.

curl -X GET "http://localhost:3000/v2/effects/tran:12345@pbz.hr/changes/1" \
  -H "x-ledger: bog"

effect change record

{
  "luid": "$wlt.7mSVWFKX-Tfx2NsNj",
  "hash": "4969e3c012b66d88cec597bf337fc01eab8d651e6ed2d5c40236cc1f7d93435a",
  "meta": {
    "action": "create",
    "moment": "2019-08-24T14:15:22Z",
    "change": 1
  },
  "data": {
    "handle": "tran:12345@pbz.hr",
    "parent": "4969e3c012b66d88cec597bf337fc01eab8d651e6ed2d5c40236cc1f7d93435a",
    "access": [
      {
        "signer": {
          "format": "ed25519-raw",
          "public": {
            "$eq": "WAweF9PHlboQoW0z8NqhZXFmzUTaV74NRFAd/aILprE="
          },
          "custom": {
            "type": "person",
            "age": {
              "$gte": 21
            }
          },
          "handle": {
            "$in": [
              "admin"
            ]
          }
        },
        "record": "any",
        "action": "any",
        "invoke": "wallet.canSpendAllChangedRouteTargets",
        "bearer": {
          "iss": "company.org",
          "sub": "admin",
          "aud": "ledger",
          "hsh": true,
          "$signer": {
            "format": "ed25519-raw",
            "public": {
              "$eq": "WAweF9PHlboQoW0z8NqhZXFmzUTaV74NRFAd/aILprE="
            },
            "custom": {
              "type": "person",
              "age": {
                "$gte": 21
              }
            },
            "handle": {
              "$in": [
                "admin"
              ]
            }
          }
        },
        "filter": {
          "schema": "bank"
        },
        "change": {
          "schema": "p2p"
        }
      }
    ],
    "custom": {
      "type": "PERSON",
      "reference": 3284759238475
    },
    "schema": "tran:12345@pbz.hr",
    "signal": "anchor-created",
    "filter": {
      "wallet.data.handle": "bank1"
    },
    "action": {
      "schema": "webhook",
      "endpoint": "http://bank1.minkainc.dev/webhook/balance-received"
    }
  }
}