subsystem-summary-of-soroban-env

Summarize the Soroban environment subsystem, covering common and host components.

3.3k|1.1k|Updated Nov 24, 2014
One-click install
npx skills add https://github.com/stellar/stellar-core --skill subsystem-summary-of-soroban-env
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: subsystem-summary-of-soroban-env
Source: https://github.com/stellar/stellar-core/tree/main/.claude/skills/subsystem-summary-of-soroban-env
Command: npx skills add https://github.com/stellar/stellar-core --skill subsystem-summary-of-soroban-env

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a concise technical overview of the Soroban environment subsystem, clarifying its architecture and key components for developers working with Soroban smart contracts.

Core Features & Use Cases

  • Architecture Breakdown: Explains the separation into soroban-env-common and soroban-env-host.
  • Key Data Types: Details Val, wrapper types, and host objects.
  • Runtime Components: Describes Host, Frame, Context, Storage, and Budget.
  • Use Case: A developer new to Soroban can quickly grasp the fundamental building blocks of the smart contract execution environment without needing to read extensive documentation.

Quick Start

Read this skill for a token-efficient summary of the soroban-env subsystem.

Frequently Asked Questions about subsystem-summary-of-soroban-env

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is the Soroban environment and how does its runtime architecture work?

The Soroban environment is a smart contract execution runtime split into `soroban-env-common` and `soroban-env-host` components. It manages VM execution, call stacks, storage access, and budget metering for blockchain smart contracts.

How do I understand the Val type and host objects in Soroban smart contracts?

The `Val` type in Soroban smart contracts serves as the fundamental data representation, supported by wrapper types and host objects. It enables efficient data passing between the guest contract and the host environment.

How does Soroban handle storage access and budget metering during smart contract execution?

Soroban handles storage access and budget metering through its `Host` implementation and runtime components. It tracks resource usage via `Frame`, `Context`, and `Budget` mechanisms to ensure controlled smart contract execution.

Can I use this summary to learn about event handling and authorization in Soroban smart contracts?

Yes, this summary explains event handling, authorization, dispatch mechanisms, and built-in contracts within the Soroban smart contract environment. It details how these runtime components interact during VM execution.

Do I need prior knowledge of the soroban-env-common and soroban-env-host split to understand this blockchain environment?

No, this summary explains the architecture split between `soroban-env-common` and `soroban-env-host` from scratch. It breaks down the fundamental building blocks for developers new to the Soroban smart contract execution environment.

Why does the Soroban runtime use Frame and Context components for smart contract call stacks?

The Soroban runtime uses `Frame` and `Context` components to manage the smart contract call stack and maintain execution state. This structure supports secure VM execution and proper dispatch mechanisms.