Methods

// npm install @stellar/stellar-sdk; save as keys.mjs and run `node keys.mjs`
import { Address, Keypair, rpc, xdr } from '@stellar/stellar-sdk';

const { RPC_URL, ACCOUNT, CONTRACT, LUMEUS_API_KEY } = process.env;
const server = new rpc.Server(RPC_URL, { headers: { Authorization: `Bearer ${LUMEUS_API_KEY}` } });

// The account entry of a G... address.
const accountKey = xdr.LedgerKey.account(
  new xdr.LedgerKeyAccount({ accountId: Keypair.fromPublicKey(ACCOUNT).xdrPublicKey() }),
);
// The instance entry of a C... contract (its code hash and instance storage).
const instanceKey = xdr.LedgerKey.contractData(
  new xdr.LedgerKeyContractData({
    contract: new Address(CONTRACT).toScAddress(),
    key: xdr.ScVal.scvLedgerKeyContractInstance(),
    durability: xdr.ContractDataDurability.persistent,
  }),
);

const { entries, latestLedger } = await server.getLedgerEntries(accountKey, instanceKey);
console.log(`${entries.length} entries at ledger ${latestLedger}`);
for (const e of entries) {
  console.log('last modified', e.lastModifiedLedgerSeq, 'live until', e.liveUntilLedgerSeq ?? 'n/a');
}
// The base64 key is what a raw JSON-RPC call sends in params.keys.
console.log(accountKey.toXDR('base64'));

# pip install stellar-sdk; save as keys.py and run `python keys.py`
import os

from stellar_sdk import Address, Keypair, SorobanServer, xdr
from stellar_sdk.client.requests_client import RequestsClient

# num_retries=0: raise 429/503 at once instead of sleeping through Retry-After.
server = SorobanServer(
    os.environ["RPC_URL"],
    client=RequestsClient(num_retries=0, custom_headers={"Authorization": f"Bearer {os.environ['LUMEUS_API_KEY']}"}),
)

# The account entry of a G... address.
account_key = xdr.LedgerKey(
    type=xdr.LedgerEntryType.ACCOUNT,
    account=xdr.LedgerKeyAccount(account_id=Keypair.from_public_key(os.environ["ACCOUNT"]).xdr_account_id()),
)
# The instance entry of a C... contract (its code hash and instance storage).
instance_key = xdr.LedgerKey(
    type=xdr.LedgerEntryType.CONTRACT_DATA,
    contract_data=xdr.LedgerKeyContractData(
        contract=Address(os.environ["CONTRACT"]).to_xdr_sc_address(),
        key=xdr.SCVal(xdr.SCValType.SCV_LEDGER_KEY_CONTRACT_INSTANCE),
        durability=xdr.ContractDataDurability.PERSISTENT,
    ),
)

response = server.get_ledger_entries([account_key, instance_key])
print(f"{len(response.entries)} entries at ledger {response.latest_ledger}")
for e in response.entries:
    print("last modified", e.last_modified_ledger, "live until", e.live_until_ledger or "n/a")
# The base64 key is what a raw JSON-RPC call sends in params.keys.
print(account_key.to_xdr())

# The account key of $ACCOUNT, as printed by the SDK examples.
curl -sS --fail-with-body "$RPC_URL/" \
  -H "Authorization: Bearer $LUMEUS_API_KEY" -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":1,"method":"getLedgerEntries","params":{"keys":["AAAAAAAAAAAQfdFrLDgzSIIugR73qs8U0ZiKbwBUclTTPh5thlbgnA=="]}}' \
  | jq -c '.result.entries[] | {lastModifiedLedgerSeq}'