/** * this test requires / asumes that the test wallet it uses contains a balance * * we keep the wallet topped off with some coins, * but if some funny guy ever empties it or if you use your own API key to run the test then it needs to be topped off again * * @throws \Exception */ public function testWalletTransaction() { $client = $this->setupBlocktrailSDK(); /** @var Wallet $wallet */ $wallet = $client->initWallet(["identifier" => "unittest-transaction", "passphrase" => "password"]); $this->assertEquals("give pause forget seed dance crawl situate hole keen", $wallet->getPrimaryMnemonic()); $this->assertEquals("unittest-transaction", $wallet->getIdentifier()); $this->assertEquals("M/9999'", $wallet->getBlocktrailPublicKeys()[9999][1]); $this->assertEquals("tpubD9q6vq9zdP3gbhpjs7n2TRvT7h4PeBhxg1Kv9jEc1XAss7429VenxvQTsJaZhzTk54gnsHRpgeeNMbm1QTag4Wf1QpQ3gy221GDuUCxgfeZ", $wallet->getBlocktrailPublicKeys()[9999][0]); $this->assertEquals("tpubD9q6vq9zdP3gbhpjs7n2TRvT7h4PeBhxg1Kv9jEc1XAss7429VenxvQTsJaZhzTk54gnsHRpgeeNMbm1QTag4Wf1QpQ3gy221GDuUCxgfeZ", $wallet->getBlocktrailPublicKey("m/9999'")->key()); $this->assertEquals("tpubD9q6vq9zdP3gbhpjs7n2TRvT7h4PeBhxg1Kv9jEc1XAss7429VenxvQTsJaZhzTk54gnsHRpgeeNMbm1QTag4Wf1QpQ3gy221GDuUCxgfeZ", $wallet->getBlocktrailPublicKey("M/9999'")->key()); list($confirmed, $unconfirmed) = $wallet->getBalance(); $this->assertGreaterThan(0, $confirmed + $unconfirmed, "positive unconfirmed balance"); $this->assertGreaterThan(0, $confirmed, "positive confirmed balance"); list($path, $address) = $wallet->getNewAddressPair(); $this->assertTrue(strpos($path, "M/9999'/0/") === 0); $this->assertTrue(BitcoinLib::validate_address($address, false, null)); ///* $value = BlocktrailSDK::toSatoshi(0.0002); $txHash = $wallet->pay([$address => $value], null, false, true, Wallet::FEE_STRATEGY_BASE_FEE); $this->assertTrue(!!$txHash); sleep(1); // sleep to wait for the TX to be processed try { $tx = $client->transaction($txHash); } catch (ObjectNotFound $e) { $this->fail("404 for tx[{$txHash}] [" . gmdate('Y-m-d H:i:s') . "]"); } $this->assertTrue(!!$tx, "check for tx[{$txHash}] [" . gmdate('Y-m-d H:i:s') . "]"); $this->assertEquals($txHash, $tx['hash']); $this->assertEquals(BlocktrailSDK::toSatoshi(0.0001), $tx['total_fee']); $this->assertTrue(count($tx['outputs']) <= 2); $this->assertTrue(in_array($value, array_column($tx['outputs'], 'value'))); //*/ /* * do another TX but with a LOW_PRIORITY_FEE */ $value = BlocktrailSDK::toSatoshi(0.0001); $txHash = $wallet->pay([$address => $value], null, false, true, Wallet::FEE_STRATEGY_LOW_PRIORITY); $this->assertTrue(!!$txHash); sleep(1); // sleep to wait for the TX to be processed try { $tx = $client->transaction($txHash); } catch (ObjectNotFound $e) { $this->fail("404 for tx[{$txHash}] [" . gmdate('Y-m-d H:i:s') . "]"); } $this->assertTrue(!!$tx, "check for tx[{$txHash}] [" . gmdate('Y-m-d H:i:s') . "]"); $this->assertEquals($txHash, $tx['hash']); $this->assertTrue(count($tx['outputs']) <= 2); $this->assertTrue(in_array($value, array_column($tx['outputs'], 'value'))); /* * do another TX but with a custom - high - fee */ $value = BlocktrailSDK::toSatoshi(0.0001); $forceFee = BlocktrailSDK::toSatoshi(0.001); $txHash = $wallet->pay([$address => $value], null, false, true, Wallet::FEE_STRATEGY_BASE_FEE, $forceFee); $this->assertTrue(!!$txHash); sleep(1); // sleep to wait for the TX to be processed try { $tx = $client->transaction($txHash); } catch (ObjectNotFound $e) { $this->fail("404 for tx[{$txHash}] [" . gmdate('Y-m-d H:i:s') . "]"); } $this->assertTrue(!!$tx, "check for tx[{$txHash}] [" . gmdate('Y-m-d H:i:s') . "]"); $this->assertEquals($txHash, $tx['hash']); $this->assertEquals($forceFee, $tx['total_fee']); $this->assertTrue(count($tx['outputs']) <= 2); $this->assertTrue(in_array($value, array_column($tx['outputs'], 'value'))); /* * do another TX with OP_RETURN using TxBuilder */ $value = BlocktrailSDK::toSatoshi(0.0002); $moon = "MOOOOOOOOOOOOON!"; $txBuilder = new TransactionBuilder(); $txBuilder->randomizeChangeOutput(false); $txBuilder->addRecipient($address, $value); $txBuilder->addOpReturn($moon); $txBuilder = $wallet->coinSelectionForTxBuilder($txBuilder); $txHash = $wallet->sendTx($txBuilder); $this->assertTrue(!!$txHash); sleep(1); // sleep to wait for the TX to be processed try { $tx = $client->transaction($txHash); } catch (ObjectNotFound $e) { $this->fail("404 for tx[{$txHash}] [" . gmdate('Y-m-d H:i:s') . "]"); } $this->assertTrue(!!$tx, "check for tx[{$txHash}] [" . gmdate('Y-m-d H:i:s') . "]"); $this->assertEquals($txHash, $tx['hash']); $this->assertTrue(count($tx['outputs']) <= 3); $this->assertEquals($value, $tx['outputs'][0]['value']); $this->assertEquals(0, $tx['outputs'][1]['value']); $this->assertEquals("6a" . "10" . bin2hex($moon), $tx['outputs'][1]['script_hex']); }
/** * create, sign and send a transaction * * @param array $outputs [address => value, ] or [[address, value], ] or [['address' => address, 'value' => value], ] coins to send * value should be INT * @param string $changeAddress change address to use (autogenerated if NULL) * @param bool $allowZeroConf * @param bool $randomizeChangeIdx randomize the location of the change (for increased privacy / anonimity) * @param null|int $forceFee set a fixed fee instead of automatically calculating the correct fee, not recommended! * @return string the txid / transaction hash * @throws \Exception */ public function pay(array $outputs, $changeAddress = null, $allowZeroConf = false, $randomizeChangeIdx = true, $forceFee = null) { if ($this->locked) { throw new \Exception("Wallet needs to be unlocked to pay"); } $outputs = self::normalizeOutputsStruct($outputs); $txBuilder = new TransactionBuilder(); $txBuilder->randomizeChangeOutput($randomizeChangeIdx); foreach ($outputs as $output) { $txBuilder->addRecipient($output['address'], $output['value']); } $this->coinSelectionForTxBuilder($txBuilder, true, $allowZeroConf, $forceFee); $apiCheckFee = $forceFee === null; return $this->sendTx($txBuilder, $apiCheckFee); }