blocktrail / blocktrail-sdk-php

     * @param  string  $identifier a unique identifier to associate with this webhook

     * @return array               associative array containing the response

     */

    public function setupWebhook($url, $identifier = null) {

        $postData = [

            'url'        => $url,

            'identifier' => $identifier

        ];

        $response = $this->client->post("webhook", null, $postData, RestClient::AUTH_HTTP_SIG);

        return self::jsonDecode($response->body(), true);

    }

    /**

     * update an existing webhook

     * @param  string  $identifier  the unique identifier of the webhook to be triggered

     * @return array                associative array containing the response

     */

    public function subscribeNewBlocks($identifier) {

        $postData = [

            'event_type'    => 'block',

        ];

        $response = $this->client->post("webhook/{$identifier}/events", null, $postData, RestClient::AUTH_HTTP_SIG);

        return self::jsonDecode($response->body(), true);

    }

    /**

     * removes an transaction event subscription from a webhook

     * @param  integer          $limit   pagination: records per page

     * @return array                     associative array containing the response

     */

    public function allWallets($page = 1, $limit = 20) {

        $queryString = [

            'page' => $page,

            'limit' => $limit

        ];

        $response = $this->client->get("wallets", $queryString, RestClient::AUTH_HTTP_SIG);

        return self::jsonDecode($response->body(), true);

    }

    /**

     * send raw transaction

     * @return mixed

     * @throws \Exception

     */

    public function faucetWithdrawl($address, $amount = 10000) {

        $response = $this->client->post("faucet/withdrawl", null, [

            'address' => $address,

            'amount' => $amount,

        ], RestClient::AUTH_HTTP_SIG);

        return self::jsonDecode($response->body(), true);

    }

    /**

     * verify a message signed bitcoin-core style