Applications and blobs

Applications are the WASM programs a context runs. Blobs are the binary objects (including application bytecode) the node stores. This guide covers both.

Installing an application

Install by the coordinates the application is published at. The node fetches the bundle from the registry it is configured with:

result = client.install_application(
    package="com.example.app",
    version="1.0.0",
)

For local development, install straight from a bundle on the node’s filesystem:

client.install_dev_application("/path/to/app.mpk")

Note

Neither call takes metadata: the node reads it from the bundle’s own manifest, so an application’s metadata is whatever it was packaged with. If the node’s configured source has nothing published at those coordinates, the call fails with 502.

Listing and inspecting

client.list_applications()                        # all installed applications
client.get_application("<application-id>")         # one application's info
client.list_application_versions("<application-id>")  # retained bytecode versions

list_application_versions returns each locally retained bytecode version — the latest install plus any older blobs still referenced by groups or context activation markers. Each row’s blobId doubles as the app_key accepted by create_namespace.

Removing an application

client.uninstall_application("<application-id>")

Application aliases

Give an application a friendly name:

client.create_application_alias("my-app", "<application-id>")
client.lookup_application_alias("my-app")
client.resolve_application_alias("my-app")
client.list_application_aliases()
client.delete_application_alias("my-app")

Blobs

Upload raw bytes, optionally scoped to a context:

info = client.upload_blob(b"...raw bytes...", context_id=None)

Download returns the blob’s bytes directly:

data = client.download_blob("<blob-id>", context_id=None)  # -> bytes

Inspect and manage stored blobs:

client.list_blobs()                    # all blobs
client.get_blob_info("<blob-id>")      # one blob's metadata
client.delete_blob("<blob-id>")        # remove a blob

Blob IDs are validated — an invalid ID raises ValueError.

Next steps

Working with contextsRun an installed application in a context.

Namespaces and groupsPin an application version to a namespace.