Hand 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.