public static void Main(string[] args)
{
OTAPI_Basic.AppStartup();
// These functions are perfect examples of the 'Low-level API',
// which is useful for simple functions that don't require messaging
// any OT servers. See OTAPI_Basic.h and OTAPI.h for the complete
// low-level API.
OTAPI_Basic.Init();
OTAPI_Basic.LoadWallet();
// ---------------------------------------------------------
// Use the low-level API to see how many server contracts
// are in the user's wallet.
int count = OTAPI_Basic.GetServerCount();
Console.Out.WriteLine("Server count {0}", count.ToString());
// ---------------------------------------------------------
// OT MADE EASY (high-level API)
// This object handles all the request/response going on with
// any servers, plus all the retries and synchronization. It's
// the 'High-level API'. See OTMadeEasy.h and OT_ME.h for the
// complete set of high-level API functions.
OTMadeEasy otme = new OTMadeEasy();
// ---------------------------------------------------------
//
// Use the High-level API to download a user's public key from
// the server. (Obviously this will fail if the server is not
// running, or if the test data is not installed.)
string strCheck = otme.check_user("r1fUoHwJOWCuK3WBAAySjmKYqsG6G2TYIxdqY6YNuuG",
"DYEB6U7dcpbwdGrftPnslNKz76BDuBTFAjiAgKaiY2n",
"HpDoVBTix9GRLvZZoKBi2zv2f4IFVLmRrW2Q0nAA0OH");
// ---------------------------------------------------------
// objEasy.check_user corresponds to the command-line:
// 'opentxs checknym'
//
// It's a useful test because it shows whether a server message
// is successful, before going the extra step of trying a real
// financial transaction.
//
// Therefore we only need to verify the Message Success, and not
// any transaction success. (Remember, a successful message can
// still contain a failed transaction.)
int nResult = otme.VerifyMessageSuccess(strCheck);
if (nResult < 0)
{
Console.Out.WriteLine("Error in check nym. Is the server running? Is the test data in ~/.ot ?");
}
if (nResult == 0)
{
Console.Out.WriteLine("Failure in check nym. Is the test data in ~/.ot ?");
}
if (nResult == 1)
{
Console.Out.WriteLine("Success in check nym.");
}
else
{
Console.Out.WriteLine("Unexpected return value in check nym.");
}
// ---------------------------------------------------------
//
// Use the high-level API to withdraw some cash (1 silver gram)
// from FT's Silver account. (Obviously this will not work if the
// localhost server is not running, or if the test data is not
// installed to ~/.ot )
// This is a "real" financial transaction:
//
// Make sure we ahve the proper mint...
string strMint = otme.load_or_retrieve_mint("r1fUoHwJOWCuK3WBAAySjmKYqsG6G2TYIxdqY6YNuuG",
"DYEB6U7dcpbwdGrftPnslNKz76BDuBTFAjiAgKaiY2n",
"7f8nlUn795x8931JParRnmKAyw8cegRyBMcFg9FccaF");
if (otme.VerifyMessageSuccess(strMint) < 0)
{
Console.Out.WriteLine("Failure: Unable to load or retrieve necessary mint file for withdrawal..");
}
string strWithdraw = otme.withdraw_cash("r1fUoHwJOWCuK3WBAAySjmKYqsG6G2TYIxdqY6YNuuG",
"DYEB6U7dcpbwdGrftPnslNKz76BDuBTFAjiAgKaiY2n",
"yQGh0vgm9YiqYOh6bfLDxyAA7Nnh2NmturCQmOt4LTo", "1");
// ---------------------------------------------------------
// InterpretTransactionMsgReply
//
// This function first verifies whether the message itself was a
// success. (For example, what if the server was down, and never
// received it?)
//
// Once it verifies that the reply was successful as a message,
// then it peers deeper, to see whether the balance agreement was
// successful as well. (After all, any transaction is automatically
// rejected if the balance agreement is poorly-formed.)
//
// Then if the balance agreement was successful, then finally,
// this same function (InterpretTransactionMsgReply) checks to see
// whether the transaction ITSELF was successful. After all, maybe
// there was an error saving it back to disk on the server side
// and this caused the transaction to fail. Or maybe there wasn't
// enough money in the account. Etc. All of the above work is done
// in the below call:
nResult = otme.InterpretTransactionMsgReply("r1fUoHwJOWCuK3WBAAySjmKYqsG6G2TYIxdqY6YNuuG",
"DYEB6U7dcpbwdGrftPnslNKz76BDuBTFAjiAgKaiY2n",
"yQGh0vgm9YiqYOh6bfLDxyAA7Nnh2NmturCQmOt4LTo",
"withdraw_cash", strWithdraw);
if (nResult < 0)
{
Console.WriteLine("Error in withdraw cash. Is the server running? Is the test data in ~/.ot ?");
}
if (nResult == 0)
{
Console.WriteLine("Failure in withdraw cash. Is the test data installed in ~/.ot ?");
}
if (nResult == 1)
{
Console.WriteLine("Success in withdraw cash! (Using high-level API in C#.");
}
else
{
Console.Out.WriteLine("Unexpected return value in withdraw cash.");
}
// ---------------------------------------------------------
// At this point we're done. We've downloaded a public key from
// the OT server, and we've also withdrawn a little cash from the
// server. We've demonstrated that both the high-level and
// low-level OT APIs are operational through C#.
// So... we're done. Let's shutdown OT and finish execution.
// (Using the low-level API...)
OTAPI_Basic.Output(0, "One more thing: Successfully used OT_API_Output.");
OTAPI_Basic.AppShutdown();
// P.S. to see the complete OT high-level API: OTMadeEasy.h
// and to see the complete OT low-level API: OTAPI_Basic.h
//
// See the Open-Transactions/include/otapi folder for all
// relevant headers. OTMadeEasy is a wrapper for OT_ME, and
// OTAPI_Basic is a wrapper for OTAPI.
//
// One more thing: If you want to see a lot of free sample code
// similar to the above code, which shows you how to use all the
// different OT API function calls, check out this file:
//
// Open-Transactions/scripts/ot/ot_commands.ot
//
// (It contains the complete implementation for a command-line
// Open-Transactions client.)
// --------------------------------------
}
public static void Main(string[] args)
{
OTAPI_Basic.AppStartup();
// These functions are perfect examples of the 'Low-level API',
// which is useful for simple functions that don't require messaging
// any OT servers. See OTAPI_Basic.h and OTAPI.h for the complete
// low-level API.
OTAPI_Basic.Init();
OTAPI_Basic.LoadWallet();
// ---------------------------------------------------------
// Use the low-level API to see how many server contracts
// are in the user's wallet.
int count = OTAPI_Basic.GetServerCount();
Console.Out.WriteLine("Server count {0}", count.ToString());
// ---------------------------------------------------------
// OT MADE EASY (high-level API)
// This object handles all the request/response going on with
// any servers, plus all the retries and synchronization. It's
// the 'High-level API'. See OTMadeEasy.h and OT_ME.h for the
// complete set of high-level API functions.
OTMadeEasy otme = new OTMadeEasy();
// ---------------------------------------------------------
//
// Use the High-level API to download a user's public key from
// the server. (Obviously this will fail if the server is not
// running, or if the test data is not installed.)
string strCheck = otme.check_user("tBy5mL14qSQXCJK7Uz3WlTOKRP9M0JZksA3Eg7EnnQ1",
"T1Q3wZWgeTUoaUvn9m1lzIK5tn5wITlzxzrGNI8qtaV",
"T1Q3wZWgeTUoaUvn9m1lzIK5tn5wITlzxzrGNI8qtaV");
// ---------------------------------------------------------
// objEasy.check_user corresponds to the command-line:
// 'opentxs checknym'
//
// It's a useful test because it shows whether a server message
// is successful, before going the extra step of trying a real
// financial transaction.
//
// Therefore we only need to verify the Message Success, and not
// any transaction success. (Remember, a successful message can
// still contain a failed transaction.)
int nResult = otme.VerifyMessageSuccess(strCheck);
if (nResult < 0)
{
Console.Out.WriteLine("Error in check nym. Is the server running? Is the test data in ~/.ot ?");
}
if (nResult == 0)
{
Console.Out.WriteLine("Failure in check nym. Is the test data in ~/.ot ?");
}
if (nResult == 1)
{
Console.Out.WriteLine("Success in check nym.");
}
else
{
Console.Out.WriteLine("Unexpected return value in check nym.");
}
// ---------------------------------------------------------
//
// Use the high-level API to withdraw some cash (1 silver gram)
// from FT's Silver account. (Obviously this will not work if the
// localhost server is not running, or if the test data is not
// installed to ~/.ot )
// This is a "real" financial transaction:
//
// Make sure we ahve the proper mint...
string strMint = otme.load_or_retrieve_mint("tBy5mL14qSQXCJK7Uz3WlTOKRP9M0JZksA3Eg7EnnQ1",
"T1Q3wZWgeTUoaUvn9m1lzIK5tn5wITlzxzrGNI8qtaV",
"CvHGtfOOKzQKL5hFL7J4iF5yAodVKhS1rxPzME5R9XA");
if (otme.VerifyMessageSuccess(strMint) < 0)
{
Console.Out.WriteLine("Failure: Unable to load or retrieve necessary mint file for withdrawal..");
}
string strWithdraw = otme.withdraw_cash("tBy5mL14qSQXCJK7Uz3WlTOKRP9M0JZksA3Eg7EnnQ1",
"T1Q3wZWgeTUoaUvn9m1lzIK5tn5wITlzxzrGNI8qtaV",
"eMldMMiKfJRO8B8yJjzcezs9xvSt7dkdlWt50e8CDxn", "1");
// ---------------------------------------------------------
// InterpretTransactionMsgReply
//
// This function first verifies whether the message itself was a
// success. (For example, what if the server was down, and never
// received it?)
//
// Once it verifies that the reply was successful as a message,
// then it peers deeper, to see whether the balance agreement was
// successful as well. (After all, any transaction is automatically
// rejected if the balance agreement is poorly-formed.)
//
// Then if the balance agreement was successful, then finally,
// this same function (InterpretTransactionMsgReply) checks to see
// whether the transaction ITSELF was successful. After all, maybe
// there was an error saving it back to disk on the server side
// and this caused the transaction to fail. Or maybe there wasn't
// enough money in the account. Etc. All of the above work is done
// in the below call:
nResult = otme.InterpretTransactionMsgReply("tBy5mL14qSQXCJK7Uz3WlTOKRP9M0JZksA3Eg7EnnQ1",
"T1Q3wZWgeTUoaUvn9m1lzIK5tn5wITlzxzrGNI8qtaV",
"eMldMMiKfJRO8B8yJjzcezs9xvSt7dkdlWt50e8CDxn",
"withdraw_cash", strWithdraw);
if (nResult < 0)
{
Console.WriteLine("Error in withdraw cash. Is the server running? Is the test data in ~/.ot ?");
}
if (nResult == 0)
{
Console.WriteLine("Failure in withdraw cash. Is the test data installed in ~/.ot ?");
}
if (nResult == 1)
{
Console.WriteLine("Success in withdraw cash! (Using high-level API in C#.");
}
else
{
Console.Out.WriteLine("Unexpected return value in withdraw cash.");
}
// ---------------------------------------------------------
// At this point we're done. We've downloaded a public key from
// the OT server, and we've also withdrawn a little cash from the
// server. We've demonstrated that both the high-level and
// low-level OT APIs are operational through C#.
// So... we're done. Let's shutdown OT and finish execution.
// (Using the low-level API...)
OTAPI_Basic.Output(0, "One more thing: Successfully used OT_API_Output.");
OTAPI_Basic.AppShutdown();
// P.S. to see the complete OT high-level API: OTMadeEasy.h
// and to see the complete OT low-level API: OTAPI_Basic.h
//
// See the Open-Transactions/include/otapi folder for all
// relevant headers. OTMadeEasy is a wrapper for OT_ME, and
// OTAPI_Basic is a wrapper for OTAPI.
//
// One more thing: If you want to see a lot of free sample code
// similar to the above code, which shows you how to use all the
// different OT API function calls, check out this file:
//
// Open-Transactions/scripts/ot/ot_commands.ot
//
// (It contains the complete implementation for a command-line
// Open-Transactions client.)
// --------------------------------------
}