Transfer records
transfer_recordsHand your records over from the gateway's wallet to an address you choose,
in one transaction. IRREVERSIBLE: once the block confirms, the gateway can no
longer change, renew or return them — nor can anyone else but the holder of
to_address. Values are carried over unchanged, and each record gets about a
century added to its term, since the gateway will not be able to renew it.
Why you might: with an address whose key you hold, the records are really yours — you can prove control by signing, and payments sent to your identity name reach you rather than the gateway. Changing a record afterwards needs your own Emercoin node and its fees. With an address no one holds a key to, the records are sealed: provably unchangeable by anyone until the term ends. If you only want proof that something existed at a given time, do not transfer — a record held by the gateway is already dated.
Only records under your own identity (ai:gh:<github_id> and its :mem:
records) can be moved, and only once they are confirmed. Requires a signed-in
session; each record counts as one write against the FREE-tier limits. After
a transfer, register_identity and re-storing a moved hash fail with
not_held; new memories are held by the gateway again.
Changing a record costs a network fee in EMC. If you hold the key and have no
EMC, set fee_grant: the gateway then also sends 0.01 EMC (about fifty value
updates) to to_address in a separate transaction — once per GitHub account,
within a daily budget. If it is not available the call is refused before
anything moves (fee_grant_used, fee_grant_unavailable), so you can decide
to transfer without it. Do not ask for it with an address no one holds a key
to: nobody could spend it. Returns the transaction id, the names moved, the
fee funds if sent, and a plain statement of what changes.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| names | No | Records to transfer, e.g. ["ai:gh:123", "ai:gh:123:mem:<hash>"] — only your own. Omit and set `everything` instead to move them all. | |
| fee_grant | No | Also send a small amount of EMC to `to_address` to pay network fees for changing these records later from your own node. Once per account; refused before anything moves if it is not available. | |
| everything | No | Transfer your identity and every live memory at once (up to 100). Use instead of `names`. | |
| to_address | Yes | Emercoin address that will hold the records from now on. Any valid address is accepted: one whose key you hold, or one no one holds a key to, which seals the records. | |
| irreversible | Yes | Must be true. Confirms you understand the gateway can never change, renew or return these records afterwards. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| txid | Yes | ||
| after | Yes | ||
| count | Yes | ||
| names | Yes | ||
| quota | Yes | ||
| fee_grant | Yes | ||
| to_address | Yes |