Skip to content
lsl.devlsl.devLSL Dev

transaction_result

View as MarkdownThis page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page
event
Event syntax
transaction_result(
  1. key id,// Key matching the handle returned by the initiating llTransfer* function.
  2. integer success,// Boolean. TRUE if the L$ transfer succeeded, FALSE otherwise.
  3. string data// Contains a CSV string of transaction info on success, or an error string on failure.
) { … }

Triggered when an asynchronous L$ transfer (such as llTransferLindenDollars) is completed. Passes transaction info id, success status, and CSV or error data.

Triggered when task receives asynchronous data

How to use
transaction_result(key id, integer success, string data)
{


}

Specification

Section titled “Specification”
llTransfer* Function ---- data CSV ContentsError Tag (Returned from data)Error Tag Description
key llTransferLindenDollars( key destination, integer amount ) ---- [ key destination, integer amount ]LINDENDOLLAR_INSUFFICIENTFUNDSThe source agent does not have enough L$ for the transfer
LINDENDOLLAR_ENTITYDOESNOTEXISTThe destination UUID is not a valid agent.
LINDENDOLLAR_BADCLOCKSKEWThere is bad clock skew between the sim host and the L$ service
INVALID_DESTINATIONDestination agent is not a valid UUID
INVALID_AMOUNTAmount is <= 0
THROTTLEDThe scripted L$ throttle was hit for this object owner.
MISSING_PERMISSION_DEBITThe script does not have debit permission
GROUP_OWNEDThe object is group owned and thus can’t give money
TRANSFERS_DISABLEDL$ transfers are disabled in the region
EXPIREDThe simulator timed out waiting for a response from the back-end service.
SERVICE_ERRORThere was an error connecting to the back-end service
LINDENDOLLAR_TRANSACTIONTIMEOUTThe transaction timed out.

Examples

Section titled “Examples”
Example 1
116 collapsed lines
/*
* A simple piggy bank, anyone can pay in money and anyone can click it to get money out.
*
* TO DO:
*  - handle different errors differently based upon CSV output
*
* original by Strife Onizuka
*
* modified by Kireji Haiku:
*  - because weird things happen in LSL when using more than one state
*  - one should say thanks when being payed
*  - added 0 L$ payment when bank is empty, to show failed payment notifications
*  - added target UUID and L$ amount into transaction history, too
*
* Note from Traven Sachs (VWR-28201):
* In testing this script using an account with no funds - it has been noted that when the INSUFFICIENT FUNDS
* error occurs on Transaction Results that the Display of L$ on the account attempting to transfer funds will
* read as -1 on some viewers, even if the account has funds less than the transaction amount available to it.
* (i.e. if account has 7L and attempts to pay 10L the viewer display will read -1 L until the next L$ transaction
* occurs that is actually valid.  Don't know if this is a viewer glitch or back end glitch but felt it should
* be mentioned.)
*/


integer hasBeenGrantedDebitPerms;


integer amountGivenAwayOnClick;
integer totalLindenDollarsInBank;


list listOfTransactionRecords;


update_floattext()
{
    string floattext = "I have no L$ to give away :(";


    if (amountGivenAwayOnClick <= totalLindenDollarsInBank
        && hasBeenGrantedDebitPerms)
    {
        floattext = "I have L$ "+ (string)totalLindenDollarsInBank + " to give away!";
    }


    llSetText(floattext, <1.0, 1.0, 1.0>, (float)TRUE);
}


default
{
    on_rez(integer start_param)
    {
        llResetScript();
    }




    changed(integer change)
    {
        if (change & CHANGED_OWNER)
            llResetScript();
    }


    state_entry()
    {
        // how much money to give away each time?


        amountGivenAwayOnClick = 10;


        // how much money do we initially "have" in the bank?


        totalLindenDollarsInBank = 50;


        update_floattext();


        // request permissions to give away money, otherwise this won't work


        key owner = llGetOwner();
        llRequestPermissions(owner, PERMISSION_DEBIT);
    }


    touch_start(integer num_detected)
    {
        // if the script has been granted debit permissions
        if (hasBeenGrantedDebitPerms)
        {
            key id = llDetectedKey(0);


            // if we have at least as much money in the bank as we would be giving away
            if (amountGivenAwayOnClick <= totalLindenDollarsInBank)
            {
                // we add the transaction ID, the target avatar UUID and the L$ amount to a list
                listOfTransactionRecords += [llTransferLindenDollars(id, amountGivenAwayOnClick), id, amountGivenAwayOnClick];


                // we take the money from the bank
                totalLindenDollarsInBank -= amountGivenAwayOnClick;
            }
            else
            {
                // will not work, cause paying 0 L$!
                // will send a "failed payment" notification!
                // only for DEMO purposes, usually you should do something like:
                // llSay(PUBLIC_CHANNEL, "Sorry, no money in the bank!");
                // instead !!!


                listOfTransactionRecords += [llTransferLindenDollars(id, 0), id, 0];
            }
        }


        update_floattext();
    }


    money(key id, integer amount)
    {
        // someone payed the bank!


        totalLindenDollarsInBank += amount;


        // be nice, say thanks
        llInstantMessage(id, "Thanks a bunch!");


        update_floattext();
    }


    transaction_result(key id, integer success, string data)
    {
        integer index = llListFindList(listOfTransactionRecords, [id]);


        //if the ID was found in our list
        if (~index)
        {
            // if payment failed, give notice
            if (!success)
            {
                key targetUUID = llList2Key(listOfTransactionRecords, index + 1);
                integer amountNotPayed = llList2Integer(listOfTransactionRecords, index + 2);


                llSay(PUBLIC_CHANNEL, "\n \nSorry, somehow the transaction has failed!"
                    + "\ntransaction ID: " + (string)id
                    + "\ntarget UUID: " + (string)targetUUID
                    + "\namount not payed: " + (string)amountNotPayed
                    + "\nfailure reason: " + data);


                // if the amount that wasn't payed is more than 0 L$, put the money back into the bank
                if (amountNotPayed)
                    totalLindenDollarsInBank += amountNotPayed;
            }


            // remove the entry again [transaction ID, target UUID, L$ amount]
            listOfTransactionRecords = llDeleteSubList(listOfTransactionRecords, index, index + 2);
        }


        // total amount could have changed again...
        update_floattext();
    }


    run_time_permissions (integer perm)
8 collapsed lines
    {
        // when owner granted debit perms, enable piggy bank functionality
        if(perm & PERMISSION_DEBIT)
            hasBeenGrantedDebitPerms = TRUE;


        update_floattext();
    }
}

History

Section titled “History”

Date of Release 03/12/2011

Original wiki source

Some wiki templates and tables need their original context. View this article on the Second Life Wiki. Technical wording and examples are retained from the source; historical guidance may differ from current behavior.