BastyonBastyon
  • Get Started

    • Getting Started
    • Easy Node Setup Guide
    • Full Node Setup Guide
  • Monetization

    • Bastyon Monetization Guide
  • Platform Overview

    • Platform Overview
    • Contributing to Bastyon
  • Blockchain Node

    • Getting Started
    • Source Code
    • Building
    • Usage
    • RPC
  • API

    • Introduction
    • Get Started
    • RPC
    • MiniApps
  • Mini Apps

    • Getting Started
    • Permissions
    • SDK
  • Barteron

    • Barteron APIs
  • English
  • Русский
  • Get Started

    • Getting Started
    • Easy Node Setup Guide
    • Full Node Setup Guide
  • Monetization

    • Bastyon Monetization Guide
  • Platform Overview

    • Platform Overview
    • Contributing to Bastyon
  • Blockchain Node

    • Getting Started
    • Source Code
    • Building
    • Usage
    • RPC
  • API

    • Introduction
    • Get Started
    • RPC
    • MiniApps
  • Mini Apps

    • Getting Started
    • Permissions
    • SDK
  • Barteron

    • Barteron APIs
  • English
  • Русский
  • Mini Apps

    • Guide to Creating Mini-Apps in Bastyon
    • Bastyon Mini-Apps Permissions
    • Bastyon SDK Reference

Bastyon Mini-Apps Permissions

Table of Contents

  • Overview
  • List of Permissions
  • Usage in Manifest

Overview

Mini-apps in Bastyon require explicit permission declarations to perform certain functions. Each permission grants access to specific platform functionality.

List of Permissions

PermissionDescriptionUsage
accountAccess to account informationGet account address, public data, and balance
signDigital data signingSign data with user's unique signature
paymentPayment processingExecute PKOIN transactions
messagingSystem messagesDisplay informational messages to user
mobilecameraCamera accessAccess mobile gallery for photo uploads
zaddressWallet address accessGet one of user's wallet addresses
externallinkExternal linksOpen links outside the platform
authFetchAuthorized requestsExecute signed requests for authentication
geolocationGeolocationGet user location data
chatChat functionsInteract with chats (send messages, manage rooms)

Usage in Manifest

Permissions are specified in the permissions field of the mini-app manifest:

{
  "id": "example.app",
  "name": "Example App",
  "permissions": [
    "account",
    "payment",
    "messaging"
  ]
}

Important: Only request permissions that are actually necessary for your mini-app's functionality.

Usage Examples

Basic Mini-App

{
  "permissions": [
    "account",
    "messaging"
  ]
}

Payment Mini-App

{
  "permissions": [
    "account",
    "payment",
    "sign",
    "zaddress"
  ]
}

Chat Mini-App

{
  "permissions": [
    "account",
    "chat",
    "messaging",
    "mobilecamera"
  ]
}

Security

  • Users always see the list of requested permissions during installation
  • Each permission can be revoked in mini-app settings
  • New permissions require confirmation when updating the mini-app

For additional information, refer to the main documentation.

Last Updated:
Contributors: gked
Prev
Guide to Creating Mini-Apps in Bastyon
Next
Bastyon SDK Reference