sway-lib-std/src/message.sw - master - githubmirror/sway

sway-lib-std/src/message.sw
79 строк2 KB
SwayStar123
Merge std and core libraries (#6729)
13 мар 2025, 01:52
13 мар 2025, 01:52a5d9d28
//! Helper functions to sign and send messages.
library;

use ::alloc::alloc_bytes;
use ::bytes::Bytes;
use ::outputs::{Output, output_count, output_type};
use ::revert::revert;
use ::ops::*;

/// Sends a message `msg_data` to `recipient` with a `coins` amount of the base asset.
///
/// # Additional Information
///
/// Use `send_typed_message` instead of `send_message` if the message needs to be indexed.
///
/// # Arguments
///
/// * `recipient`: [b256] - The address of the message recipient.
/// * `msg_data`: [Bytes] - Arbitrary length message data.
/// * `coins`: [u64] - Amount of base asset to send.
///
/// # Examples
///
/// ```sway
/// use std::{message::send_message, bytes::Bytes};
///
/// fn foo() {
///     let recipient = 0xee45573606c96c98ba970ff7cf9511f1b8b25e6bcd52ced30b89df1e4a9c4323;
///     let mut bytes = Bytes::new();
///     bytes.push(5u8);
///     send_message(recipient, bytes, 50);
/// }
/// ```
pub fn send_message(recipient: b256, msg_data: Bytes, coins: u64) {
    let recipient_pointer = __addr_of(recipient);
    let mut size = 0;
    let mut msg_data_pointer = recipient_pointer;

    // If msg_data is empty, we just ignore it and pass `smo` a pointer to the inner value of recipient.
    if !msg_data.is_empty() {
        size = msg_data.len();
        msg_data_pointer = msg_data.ptr();
    }

    asm(
        r1: recipient_pointer,
        r2: msg_data_pointer,
        r3: size,
        r4: coins,
    ) {
        smo r1 r2 r3 r4;
    };
}

/// Sends a message `msg_data` of type `T` to `recipient` with a `coins` amount of the base asset.
///
/// # Additional Information
///
/// Use `send_typed_message` instead of `send_message` if the message needs to be indexed.
///
/// # Arguments
///
/// * `recipient`: [b256] - The address of the message recipient.
/// * `msg_data`: [T] - Message data of arbitrary type `T`.
/// * `coins`: [u64] - Amount of base asset to send.
///
/// # Examples
///
/// ```sway
/// use std::message::send_typed_message;
///
/// fn foo() {
///     let recipient = 0xee45573606c96c98ba970ff7cf9511f1b8b25e6bcd52ced30b89df1e4a9c4323;
///     send_message(recipient, "Fuel is blazingly fast", 50);
/// }
/// ```
pub fn send_typed_message<T>(recipient: b256, msg_data: T, coins: u64) {
    __smo(recipient, msg_data, coins);
}