simonandCursor
1e1111c90f
Safety snapshot of mobile work before merging upstream chat-v2: - Qortino AI: QDN pack discovery/download (Q-Share ids), external app storage, install validation, teach/report Q-Mail, PDF thumbs+zoom - Android share target "Quitter" with native ShareReceiver plugin - Categorized device saves (Images/Videos/Audio/Documents/Apps/GO state) - createNamedFile helper: cordova-plugin-file clobbers global File Co-authored-by: Cursor <cursoragent@cursor.com>
56 lines
2.0 KiB
Markdown
56 lines
2.0 KiB
Markdown
# qortalRequest Patterns
|
|
|
|
## Getting the logged-in account
|
|
|
|
```js
|
|
const account = await qortalRequest({ action: "GET_USER_ACCOUNT" });
|
|
// { address, publicKey }
|
|
```
|
|
|
|
## Fetching a name's resources
|
|
|
|
```js
|
|
const res = await qortalRequest({
|
|
action: "LIST_QDN_RESOURCES",
|
|
name: "Qortino",
|
|
service: "FILE",
|
|
limit: 20,
|
|
});
|
|
```
|
|
|
|
Common pitfall: some actions require user approval popups; batch reads where
|
|
possible to avoid popup fatigue.
|
|
|
|
## qortalRequest action map
|
|
|
|
Read-only (no approval): GET_ACCOUNT_DATA, GET_ACCOUNT_NAMES, GET_NAME_DATA,
|
|
GET_BALANCE, FETCH_QDN_RESOURCE, LIST_QDN_RESOURCES, SEARCH_QDN_RESOURCES,
|
|
GET_QDN_RESOURCE_STATUS / METADATA / PROPERTIES / URL, SEARCH_NAMES,
|
|
SEARCH_TRANSACTIONS, FETCH_BLOCK, FETCH_BLOCK_RANGE, GET_AT, GET_AT_DATA,
|
|
LIST_ATS, LIST_GROUPS, GET_PRICE, GET_DAY_SUMMARY.
|
|
|
|
Require user approval (show a popup): GET_USER_ACCOUNT, GET_USER_WALLET,
|
|
GET_USER_WALLET_INFO, GET_WALLET_BALANCE, PUBLISH_QDN_RESOURCE,
|
|
PUBLISH_MULTIPLE_QDN_RESOURCES, SEND_COIN, SEND_CHAT_MESSAGE (group),
|
|
JOIN_GROUP, DEPLOY_AT, CREATE_POLL, VOTE_ON_POLL, SAVE_FILE, list actions
|
|
(GET/ADD/DELETE_LIST_ITEMS), GET_FRIENDS_LIST, SET_PROFILE_DATA,
|
|
SEARCH_CHAT_MESSAGES.
|
|
|
|
Navigation/UI: OPEN_NEW_TAB (qortal:// link), OPEN_PROFILE, notifications.
|
|
|
|
## Key gotchas
|
|
|
|
- Publishing from a Q-App supports single files or base64 only; multi-file
|
|
WEBSITE/APP publishing is not available via qortalRequest yet.
|
|
- Amounts: QORT values from GET_PRICE and transactions are integers scaled by
|
|
1e8 — divide to get QORT.
|
|
- Encrypt with ENCRYPT_DATA (pass publicKeys array for group encryption);
|
|
DECRYPT_DATA needs the counterparty public key and base64 input.
|
|
- Use qortalRequest's built-in timeouts; qortalRequestWithTimeout exists but
|
|
letting the core manage timeouts is more futureproof.
|
|
- Direct REST fetch() works for anonymous reads (e.g. /names/{name}) but
|
|
cannot identify the logged-in user — use qortalRequest for anything
|
|
personalized.
|
|
- Batch reads to avoid approval-popup fatigue; group approval-needing calls
|
|
behind explicit user actions.
|